Windows
Run the.exe installer. Use the .msi instead if you deploy with one.
Windows code signing isn’t in place yet, so SmartScreen may warn that the installer isn’t from a known publisher. Choose More info → Run anyway.
macOS
1
Drag SpeakoFlow into Applications
Open the
.dmg and drag the app across, as usual.2
Clear the quarantine flag
Open Terminal (press
Cmd + Space, type Terminal) and run:3
Open it from Launchpad, Spotlight, or Applications
macOS then asks for Microphone and Accessibility permission. Grant both.
Why macOS says the app is damaged
Why macOS says the app is damaged
The app is not damaged. That wording is what macOS shows for any app it can’t trace to a paid Apple Developer account. Signing costs $99/year, which this project doesn’t have yet.The
xattr command removes the “downloaded from the internet” tag macOS puts on the file. SpeakoFlow can’t auto-update while unsigned, so you repeat the command each time you download a new version.There is no button to click instead. macOS 15 and later removed the old right-click → Open bypass, and “damaged” is the one case where no Open Anyway button appears in System Settings → Privacy & Security. Apple code signing and notarization is on the roadmap and removes this step entirely.Apple Silicon only, and what to do on an Intel Mac
Apple Silicon only, and what to do on an Intel Mac
Builds cover M1 and newer. GitHub retired its Intel build machines in December 2025, so there is currently no way to produce and test an Intel build.On an Intel Mac you can still build from source.
What the two permissions are for
What the two permissions are for
Microphone (System Settings → Privacy & Security → Microphone). So it can hear you.Accessibility (System Settings → Privacy & Security → Accessibility). So it can type into other apps.
Linux
Prefer the
.deb where there is one. It registers the app icon and menu entry, which the AppImage can’t do on its own.
On an older release than Ubuntu 24.04
On an older release than Ubuntu 24.04
The
.deb is built on Ubuntu 24.04, so it needs that era of glibc. Use the AppImage instead.Why there is no .rpm
Why there is no .rpm
The packaging doesn’t bundle the speech engine correctly. Shipping an
.rpm that installs but can’t transcribe would be worse than not shipping one.