Zum Inhalt springen
DE
Download

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.

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.

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"

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"

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]]:

Terminal-Fenster
tilingbud subscribe space_changed window_focused | while read -r line; do
echo "$line" | jq .space_index
done

Ohne 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.

  • Eine Leiste zeichnet bei space_changed ihre Spaces neu.
  • Ein Skript setzt einen Chat-Status, wenn ein bestimmter Space sich öffnet, aus space_changed und TILINGBUD_SPACE_INDEX.
  • Ein Layout-Skript läuft, wenn ein Bildschirm angeschlossen wird, bei display_added.

Jeder Schlüssel steht in der Referenz.