System tray
Kalam runs quietly in your tray (notification area on Windows, menu bar on macOS) so shortcuts work even when the main window is closed. Closing the main window hides the interface; choose Quit Kalam only when you want to shut down the background service completely.
On Linux, attaching the panel applet hides the standalone tray icon so you do not have duplicate Kalam icons. When no panel applet is attached, Linux keeps the tray menu active without left-click window reopen—use Open Kalam in the menu instead.
Screenshot needed
system-tray-menu.webp
Visible. Tray menu Open Kalam, Turn Dictation Off, History, Settings, Permissions needed, Check for Updates, Quit Kalam.
Capture. Windows notification area, menu open, dictation active.
Alt. Kalam system tray menu open showing Open Kalam, Turn Dictation Off, History, Settings, Permissions needed, Check for Updates, and Quit Kalam.
system-tray-menu.webp is added under apps/docs/static/img/screenshots/.Menu items
| Item | Action |
|---|---|
| Open Kalam | Shows and focuses the main desktop window. (On Windows and macOS, left-clicking the tray icon also opens the window.) |
| Turn Dictation On / Off | Toggles the master dictation switch (mirrors the sidebar Microphone control). |
| History | Opens History. |
| Settings | Opens General settings. |
| Permissions needed | Enabled whenever an OS permission grant blocks dictation; jumps straight to the needed fix. |
| Check for Updates | Runs a manual update check; install available updates from Settings → About. |
| Quit Kalam | Exits Kalam and unregisters global shortcuts. |
Hovering the tray icon shows status tooltips such as Kalam - Ready, Kalam - Dictation off, Kalam - Recording..., Kalam - Processing..., or Kalam - Permissions needed.
Common tasks
Keep hotkeys running with the window hidden
- Close the main window (or turn Show Window on Startup off under General settings).
- Verify the tray icon—or your Linux panel chip—remains visible.
- Dictate from any app using your normal shortcut.
Restart or exit Kalam completely
- Open the tray menu (or the Linux panel chip menu).
- Choose Quit Kalam.