Skip to content

A tray app to manage komorebi tiling window manager for Windows.

License

Notifications You must be signed in to change notification settings

starise/komorebi-tray

Repository files navigation

Komorebi Tray

A tray app to manage komorebi tiling window manager for Windows.

  • Switch between multiple AutoHotkey profiles.
  • Show the current workspace number on tray icon.
  • Show workspace name popup on workspace change.
  • Start/Stop/Pause komorebi using the tray menu.
  • Click on the tray icon to Pause/Resume komorebi.

Komorebi can be started, stopped and paused externally and the app will adjust accordingly: it works independently from komorebi and does not require any change to your current komorebi configuration (see Quick start).

If the app is already running but the connection with komorebi is lost, the app will wait for komorebi to start. If the app is started but komorebi has not been launched yet, the app will attempt to launch komorebi. This is useful if you want to use this app as a launcher for Komorebi at Windows startup.

Komorebi Tray Preview

Quick start

Install Komorebi Tray using the latest MSI Windows Installer or Scoop.

scoop bucket add confetti https://github.com/starise/Scoop-Confetti
scoop install komorebi-tray

No changes to your default komorebi configuration are needed. The only requirement is the KOMOREBI_CONFIG_HOME environment variable set in your Microsoft.PowerShell_profile.ps1, which is used to read the current komorebi configuration and for multiple AutoHotkey profile management.

# Microsoft.PowerShell_profile.ps1
$Env:KOMOREBI_CONFIG_HOME = "$($Env:USERPROFILE)\.config\komorebi"

For more information, see the official Komorebi docs.

AutoHotkey profiles

Add your custom *.ahk scripts to $Env:KOMOREBI_CONFIG_HOME\profiles\.

  • Load new profiles: Right click -> Reload.
  • Enable a new profile: Right click -> Profiles -> profile.ahk.