Pill and overlay
On Windows and macOS, dictation status floats above your workspace as an always-on-top pill. On Linux, Kalam integrates cleanly into your desktop panel as a panel chip (managed under Pill Applet). To install the Linux chip into your panel, see Linux panel chip.
Windows & macOS overlay states
Between captures, the pill collapses into a small mark or hides until needed. During dictation it expands to track live audio and insertion status:
| State | What appears on the pill |
|---|---|
| Idle | Compact profile dot. Click to expand and see the active profile, feature summary (Polish · Context · Auto-activate), last transcript, or quick Transcribe again. |
| Listening… | Microphone opening. Protected windows show a sensitivity notice when on-device speech and blocked context apply. |
| Recording | Live waveform, profile icon and name, elapsed timer, and Stop recording. Press Escape to cancel. |
| Silent / muted mic | Warns immediately if the selected microphone is muted or sending no signal. |
| Transcribing… / Improving… | Shows processing stage, Still working…, or Trying again… (N) if retrying. |
| Inserted / Inserted N words | Confirms text landed in the target field. Click to copy the transcript before it returns to idle. |
| Copied — press Ctrl+V / Cmd+V | Appears when the target app blocks synthetic typing; your text is ready on the clipboard with Paste and Dismiss controls. |
| Error / Needs fix | Clear error headline with Retry and Dismiss actions so you do not lose the take. |
Right-click the idle pill for Start dictation, Switch mode…, Copy last transcription, and Customize pill. During an active recording or processing pass, right-click offers Stop recording or Cancel transcription.
If a take fails—or you want to re-run the last recording with a different dictation profile while audio is still in memory—click Retry on the error pill or Transcribe again on the expanded idle card.
Pill settings (Windows & macOS)
Open Pill in the sidebar to configure appearance and screen anchor. Changes apply immediately:
| Section | Options |
|---|---|
| Preview & appearance | Preview Idle, Expanded, Recording, Processing, Success, Error, or Needs fix states against a mock screen. |
| Waveform | Pick Ramp, Line, or Bars (selecting a waveform switches the preview to Recording). |
| When idle | Choose Visible dot (remains on screen), Hidden (appears only during dictation), or Hidden + peek (flashes briefly on status changes). |
| Screen position | 3×3 anchor grid (Top left through Bottom right) plus Fine-tune (5 px steps up to ±100 px) and Reset. |
Linux panel chip
Linux renders dictation status directly in your desktop panel instead of a floating overlay. Open Pill Applet in the sidebar to preview states (Idle, Recording, Transcribing, Retrying, Inserted, Copied, Error, Dictation off, Not running), toggle Live daemon mirroring, pick Ramp, Line, or Bars, adjust Chip size (plus 2.5× zoom preview), and follow the In your panel setup card.
When the panel chip is attached, clicking it during recording triggers Stop and insert. Opening the chip menu shows Modes (switch profile), Copy last transcription, Open Kalam, Cancel, and Quit Kalam (the system tray icon hides automatically while a panel applet is active so you do not see duplicate icons).