Skip to content

Commit f64e47f

Browse files
DatafyingTechclaude
andcommitted
Document Linux and macOS support status
Answer the most likely first question from anyone finding this: it is Windows-only today. Adds a breakdown of which parts are portable (recognition, audio, cleanup, Ollama, config, history) and which are Win32-bound (hotkeys, injection, focus detection, the overlay style), and names Wayland as the real obstacle to a Linux port. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 088e1b2 commit f64e47f

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

README.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,25 @@ still applies its built-in rules, just less cleverly. AMD and Intel GPUs are not
104104
**A microphone**, obviously. Anything works, including a laptop's built-in one. Audio is normalized
105105
before transcription, so a cheap mic and a quiet voice are both fine.
106106

107+
### Linux and macOS
108+
109+
**Not supported today, and it is not a small job.** Roughly two thirds of the code is portable:
110+
speech recognition, audio capture, the cleanup rules, the Ollama pass, config and history have no
111+
Windows dependency at all. The parts that do not port are the ones that make it feel instant:
112+
113+
| Piece | Portable? |
114+
|---|---|
115+
| Parakeet / Whisper recognition, audio capture, cleanup, Ollama, config, history | Yes, as-is |
116+
| Global hotkey | Mostly. `pynput` works on X11 and macOS, but Wayland blocks global key grabs |
117+
| Typing into the focused window | No. Rewrites needed for X11 (XTest), Wayland (portals, heavily restricted) or macOS (CGEvent, needs Accessibility permission) |
118+
| Focus and fullscreen detection | No. Win32-only today |
119+
| The status dot staying unfocused | No. Relies on a Win32 window style |
120+
121+
Wayland is the real obstacle: it deliberately prevents applications from reading global keys or
122+
injecting synthetic input into other windows, which is the entire mechanism LocalFlow depends on.
123+
A Linux port is realistic on X11 and macOS, and awkward on Wayland. Contributions welcome, see
124+
[CONTRIBUTING.md](CONTRIBUTING.md).
125+
107126
---
108127

109128
## Install

0 commit comments

Comments
 (0)