Signale
Ein Signal führt einen Shell-Befehl aus, wenn etwas passiert: Ein Fenster öffnet sich, der Space wechselt, eine App startet. Eine Leiste wie SketchyBar zeichnet so ihre Spaces neu.
Signale bearbeitest du unter Einstellungen › Signale: Wähle unter Neues Signal das Ereignis, tippe den
Befehl ein, beschränke ihn wahlweise auf eine App oder einen Fenstertitel und klicke auf Signal hinzufügen.
Deine Signale listet die Signale, die du hast. In der Datei ist jedes Signal ein Eintrag [[signal]]:
[[signal]]event = "space_changed"action = "sketchybar --trigger space_change"Der Befehl läuft über deine Login-Shell, losgelöst; seine Ausgabe wird nicht aufbewahrt.
Ereignisse
Abschnitt betitelt „Ereignisse“| Ereignis | Wann |
|---|---|
window_created, window_destroyed |
Ein Fenster öffnet oder schließt sich |
window_focused |
Ein Fenster bekommt den Fokus |
window_moved, window_resized |
Ein Fenster bewegt sich oder ändert seine Größe, auch wenn das Layout es platziert |
window_minimized, window_deminimized |
Ein Fenster geht ins Dock oder kommt zurück |
space_changed |
Ein anderer Space wird gezeigt |
space_created, space_destroyed |
Ein Space wird hinzugefügt oder entfernt |
display_added, display_removed |
Ein Bildschirm wird angeschlossen oder entfernt |
display_changed |
Ein anderer Bildschirm hat den Fokus |
app_launched, app_terminated |
Eine App startet oder wird beendet |
app_activated |
Eine App kommt nach vorne |
app_hidden, app_shown |
Eine App wird ausgeblendet oder wieder gezeigt |
mission_control_entered, mission_control_left |
Mission Control öffnet oder schließt sich |
system_woke |
Der Mac wacht aus dem Ruhezustand auf |
Jede Änderung wird einmal gemeldet. Die Fenster und Spaces, die beim Start von TilingBud schon da sind, sind keine Ereignisse.
Ein Signal auf Apps und Fenster beschränken
Abschnitt betitelt „Ein Signal auf Apps und Fenster beschränken“Für Fenster- und App-Ereignisse lässt sich ein Signal so beschränken wie eine
Fensterregel: app (ein Name oder ein Programmpfad), except_apps,
und title oder except_title als reguläre Ausdrücke auf den Fenstertitel. Andere Ereignisse ignorieren sie. label
gibt dem Signal einen Namen, der in den Einstellungen und in query --signals erscheint.
[[signal]]event = "window_focused"app = "iTerm2"except_title = "^vim"action = "~/bin/terminal-focused.sh"label = "terminal"Werte für den Befehl
Abschnitt betitelt „Werte für den Befehl“Der Befehl bekommt die Werte des Ereignisses als Umgebungsvariablen, jede nur dort, wo das Ereignis sie hat:
| Variable | Wert |
|---|---|
TILINGBUD_EVENT |
Der Name des Ereignisses |
TILINGBUD_WINDOW_ID |
Die ID des Fensters |
TILINGBUD_PROCESS_ID |
Die Prozess-ID der App |
TILINGBUD_SPACE_INDEX |
Die Nummer des Space über alle Bildschirme (index in query --spaces) |
TILINGBUD_SPACE_ID |
Die ID des Space |
TILINGBUD_RECENT_SPACE_INDEX |
Der vorher gezeigte Space, für space_changed |
TILINGBUD_DISPLAY_INDEX |
Die Nummer des Bildschirms |
TILINGBUD_DISPLAY_ID |
Die UUID des Bildschirms |
[[signal]]event = "space_changed"action = "sketchybar --trigger space_change SPACE=$TILINGBUD_SPACE_INDEX"Stattdessen mithören
Abschnitt betitelt „Stattdessen mithören“Ein Werkzeug kann tilingbud subscribe laufen lassen und eine JSON-Zeile pro Ereignis lesen. Pro Ereignis wird nichts
gestartet, und es braucht keinen Eintrag [[signal]]:
tilingbud subscribe space_changed window_focused | while read -r line; do echo "$line" | jq .space_indexdoneOhne Namen von Ereignissen meldet es jedes Ereignis. tilingbud subscribe nope schlägt fehl und listet die Namen der
Ereignisse. Die Felder jeder Zeile stehen in der Befehlszeile.
Typische Anwendungen
Abschnitt betitelt „Typische Anwendungen“- Eine Leiste zeichnet bei
space_changedihre Spaces neu. - Ein Skript setzt einen Chat-Status, wenn ein bestimmter Space sich öffnet, aus
space_changedundTILINGBUD_SPACE_INDEX. - Ein Layout-Skript läuft, wenn ein Bildschirm angeschlossen wird, bei
display_added.
Jeder Schlüssel steht in der Referenz.