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 for your Mac (aarch64 for Apple silicon, x64 for Intel) and drag the app across.2
Clear the quarantine flag
Open Terminal (press
Cmd + Space, type Terminal) and run:3
Open the app
Launch from Launchpad, Spotlight, or Applications. macOS then asks for Microphone and Accessibility permission. Grant both.
xattr command once per version you install from a .dmg, not once per launch. Updates installed from inside the app are not tagged, so they skip this step.
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 cannot trace to a paid Apple Developer account. Signing costs $99 a year, which this project does not have yet.The
xattr command removes the “downloaded from the internet” tag macOS puts on the file. 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. Terminal is the only way through.Intel Mac support
Intel Mac support
Builds are available for both Apple silicon and Intel. The Intel build needs
macOS 14 Sonoma or later. It runs on the processor only, so transcription is
slower than on Apple silicon, but everything works. CI runs every Intel build
on a real Intel Mac before release.
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 cannot do on its own.
Minimum glibc version
Minimum glibc version
Both packages are built on Ubuntu 24.04, so they need glibc 2.39 or newer. That rules out Ubuntu 22.04, Debian 12, Mint 21, and RHEL 9 and its rebuilds.
Why there is no .rpm
Why there is no .rpm
The packaging does not bundle the speech engine correctly. An
.rpm that
installs but cannot transcribe would be worse than not shipping one.Updates
SpeakoFlow checks for new versions in the background (8 seconds after launch, then every 12 hours) and shows available updates in Settings → About. Each update is verified against the project’s signing key before it is applied. How the update reaches you depends on how you installed:
Automatic checks can be turned off in Settings → About, and you can always check manually there too.
Versions 1.4 and earlier cannot install 2.0 from inside the app. Download 2.0
once from the Releases
page and
install it over the old version; settings and history are kept. From 2.0 on,
updates install from Settings → About.