The Pill
What the pill is
The small always-on-top overlay. It shows whether Dimmy is idle, recording, transcribing, or done.
The pill is the visual heart of Dimmy. It is a small overlay that floats above every window on your screen, like a tiny status light. It is the only persistent UI: there is no main window, no dock icon parade, no popup.
Why it exists
- You can see at a glance what Dimmy is doing without alt-tabbing.
- It doubles as a click target: left-click toggles recording, right-click opens settings.
- It changes shape and colour to reflect every step of the pipeline. No silence, no guessing.
Where it lives
By default the pill sits in the top-right corner. You can drag it anywhere on screen, or pin it to one of the four corners. See Move, resize, hide the pill.
Was this helpful?
In this category
The Pill
All pill states explained
Idle, recording, transcribing, LLM, done, error. Each one has a unique shape, colour, and animation.
The Pill
Move, resize, hide the pill
Drag the pill anywhere. Pin to a corner. Change opacity when idle. Hide it entirely until the hotkey is pressed.
The Pill
Tray and menu-bar icon
Besides the pill, Dimmy puts a tiny icon in your system tray (Windows, Linux) or menu bar (macOS). Quick access to Settings, History, Quit.
Last updated: 2026-05-22