Konfiguration
Tsumiki verwendet TOML für die Konfiguration.
Konfigurationsdateien
Abschnitt betitelt „Konfigurationsdateien“config.toml: Widgets, Layout, Module, Laufzeitverhalten.tsumiki.schema.json: Schema-Quelle der Wahrheit.
Schnellstart-Beispiel
Abschnitt betitelt „Schnellstart-Beispiel“"$schema" = "./tsumiki.schema.json"
[general]debug = falseauto_restart = truemulti_monitor = false
[layout]left_section = ["workspaces", "window_title"]middle_section = ["date_time"]right_section = ["@group:0", "system_tray", "volume", "battery"]
[[widget_groups]]widgets = ["updates", "battery"]spacing = 4style_classes = ["bordered"]
[[collapsible_groups]]widgets = ["ocr", "screenshot", "recorder"]spacing = 4label_format = ""tooltip = "Werkzeuge"style_classes = ["utility-tools"]
[modules.bar]layer = "top"location = "top"auto_hide = falseauto_hide_timeout = 3000
[widgets.workspaces]count = 10hide_unoccupied = true
[widgets.date_time]date_format = "%b %d %H:%M"
[widgets.volume]tooltip = truestep_size = 5
[widgets.battery]label = truetooltip = trueHauptabschnitte
Abschnitt betitelt „Hauptabschnitte“general
Abschnitt betitelt „general“Globales Verhalten wie Debug-Modus, automatischer Neustart und Multi-Monitor-Steuerung.
| Schlüssel | Typ | Standard | Beschreibung |
|---|---|---|---|
debug |
bool | false |
Ausführliche Protokollierung aktivieren |
auto_restart |
bool | true |
Automatischer Neustart bei Absturz |
restart_delay |
int | 1500 |
Verzögerung vor Neustart (ms) |
multi_monitor |
bool | false |
Pro-Monitor-Leisteninstanzen |
tooltips |
bool | true |
Widget-Tooltips aktivieren |
check_updates |
bool | false |
Auf Tsumiki-Updates prüfen |
monitor_styles |
bool | true |
SCSS-Änderungen überwachen und neu laden |
Steuert die Widget-Platzierung in den Leistenabschnitten:
left_sectionmiddle_sectionright_section
Jeder Wert ist eine Liste von Widget-IDs. Verwenden Sie @group:N (nullbasierter Index) für Widget-Gruppen:
[layout]left_section = ["@group:0", "window_title"]middle_section = ["date_time"]right_section = ["@group:1", "system_tray", "power"]Verfügbare Referenztypen:
| Referenz | Beispiel | Beschreibung |
|---|---|---|
| Widget-Name | "workspaces" |
Direkte Widget-Referenz |
@group:N |
"@group:0" |
Widget-Gruppe nach Index |
@collapsible:N |
"@collapsible:0" |
Einklappbare Gruppe nach Index |
modules
Abschnitt betitelt „modules“Aktiviert und konfiguriert größere UI-Module wie:
| Modul | Schlüssel | Beschreibung |
|---|---|---|
| Leiste | modules.bar |
Panel-Position und -Ebene |
| Benachrichtigungen | modules.notification |
Desktop-Benachrichtigungssystem |
| Dock | modules.dock |
App-Dock mit Intellihide |
| Übersicht | modules.overview |
Arbeitsbereichs-Exposé-Ansicht |
| OSD | modules.osd |
Bildschirmanzeige für Lautstärke usw. |
| Launcher | modules.launcher |
Anwendungssuche und -start |
| Desktop-Uhr | modules.desktop_clock |
Dekorative Desktop-Uhr |
| Desktop-Zitate | modules.desktop_quotes |
Inspirierende Zitate-Überlagerung |
| Desktop-Notizen | modules.desktop_notes |
Haftnotizen auf dem Desktop |
| Bildschirmecken | modules.screen_corners |
Aktive Ecken |
| Spickzettel | modules.cheatsheet |
Tastenkürzel-Referenz |
| Activate Linux | modules.activate_linux |
Fensteraktivierungs-Hinweis |
Beispiel für eine Dock-Konfiguration:
[modules.dock]enabled = truebehavior = "intellihide"show_when_no_windows = falseicon_size = 40Siehe die Module-Referenz für vollständige Optionen.
widgets
Abschnitt betitelt „widgets“Pro-Widget-Einstellungen (Symbole, Beschriftungen, Schwellenwerte, Abfrageintervalle, Verhaltensflags).
Es stehen über 45 Widgets zur Verfügung. Siehe die vollständige Widgets-Referenz für jede Option.
Häufige Widgets sind:
| Widget | Beschreibung |
|---|---|
workspaces |
Virtueller Desktop-Umschalter |
window_title |
Aktiver Fenstertitel |
date_time |
Datums-/Zeitanzeige |
system_tray |
System Tray-Symbole |
volume |
Audio-Lautstärkeregelung |
battery |
Akkustatus |
cpu |
CPU-Auslastungsmonitor |
memory |
Speicherauslastungsmonitor |
network_usage |
Netzwerkgeschwindigkeitsmonitor |
weather |
Wetterbedingungen |
power |
Energiemenü (Herunterfahren usw.) |
quick_settings |
Schnelleinstellungen-Panel |
Arbeitsbereichs-Stile
Abschnitt betitelt „Arbeitsbereichs-Stile“Das Arbeitsbereichs-Widget unterstützt sechs Anzeigestile:
[widgets.workspaces]style = "numbered" # "numbered" | "pill" | "icon" | "minimal" | "underline" | "bubble"- numbered — Zahlen mit pillenförmigem Aktiv-Indikator (Standard)
- pill — Minimale Pillen-Indikatoren ohne Text
- icon — Benutzerdefinierte Nerd Font-Symbole pro Arbeitsbereich
- minimal — Sauber, dezent mit subtilem Hintergrund
- underline — Aktiver Arbeitsbereich erhält unteren Randakzent, kein Hintergrund
- bubble — Kreisförmige Blasenbehälter
Widget-Gruppen und einklappbare Gruppen
Abschnitt betitelt „Widget-Gruppen und einklappbare Gruppen“Gruppieren Sie Widgets mit gemeinsamem Abstand und Stil:
[[widget_groups]]widgets = ["updates", "battery"]spacing = 4style_classes = ["bordered"]Einklappbare Gruppen verbergen Widgets hinter einem Umschalter:
[[collapsible_groups]]widgets = ["ocr", "screenshot", "recorder"]spacing = 4label_format = ""tooltip = "Werkzeuge"style_classes = ["utility-tools"]Referenzieren Sie Gruppen im Layout mit @group:N oder @collapsible:N.
Matugen-Theme-Generierung
Abschnitt betitelt „Matugen-Theme-Generierung“Generieren Sie automatisch Farbpaletten aus Ihrem Hintergrundbild:
[matugen]enabled = truewallpaper = "~/Pictures/wallpaper.jpg"scheme = "scheme-tonal-spot"mode = "dark"contrast = 0.0Siehe Theming mit Matugen für Details.
Empfohlener Arbeitsablauf
Abschnitt betitelt „Empfohlener Arbeitsablauf“- Beginnen Sie mit
example/config.toml. - Halten Sie Ihre benutzerdefinierte Datei klein und fokussiert.
- Ändern Sie jeweils einen Abschnitt.
- Starten Sie mit
./tsumiki.sh -startneu, um das Verhalten zu validieren.
Referenzquelle
Abschnitt betitelt „Referenzquelle“Diese Seite ist ein praktischer Überblick.
Vollständige Schlüsseldefinitionen und Standardwerte finden Sie in der Widgets-Referenz und der Module-Referenz.
Das vollständige Schema finden Sie in tsumiki.schema.json im Projektstammverzeichnis.