Skip to main content
Kalam Documentation

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.

Live preview of the five pill states: Idle, Listening, Processing, Inserted, and Error / retry.
Floating dictation pill in Recording state showing active waveform, profile icon, profile name, timer, and Stop recording control. (Click to zoom)

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:

StateWhat appears on the pill
IdleCompact 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.
RecordingLive waveform, profile icon and name, elapsed timer, and Stop recording. Press Escape to cancel.
Silent / muted micWarns 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 wordsConfirms text landed in the target field. Click to copy the transcript before it returns to idle.
Copied — press Ctrl+V / Cmd+VAppears when the target app blocks synthetic typing; your text is ready on the clipboard with Paste and Dismiss controls.
Error / Needs fixClear 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:

Dictation pill settings page showing Idle preview, state chips, and Ramp, Line, and Bars waveform styles. (Click to zoom)
SectionOptions
Preview & appearancePreview Idle, Expanded, Recording, Processing, Success, Error, or Needs fix states against a mock screen.
WaveformPick Ramp, Line, or Bars (selecting a waveform switches the preview to Recording).
When idleChoose Visible dot (remains on screen), Hidden (appears only during dictation), or Hidden + peek (flashes briefly on status changes).
Screen position3×3 anchor grid (Top left through Bottom right) plus Fine-tune (5 px steps up to ±100 px) and Reset.
Dictation pill preview in Expanded idle state showing profile name and Polish · Context badges. (Click to zoom)
Dictation pill preview in Error state highlighting the Retry action under Could not transcribe. (Click to zoom)

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.

Pill Applet page with chip preview, Recording selected, and panel integration steps. (Click to zoom)

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