Installation
Last updated
Download and install OiPer on Windows, macOS or Linux, grant the macOS permissions it needs for dictation, and keep the app up to date.
Download
Builds for Windows, macOS (Apple Silicon and Intel), and Linux (AppImage, .deb, and .rpm)
are on the download page and published on GitHub:
github.com/oiper/desktop/releases/latest
macOS requires version 10.15 or later.
On Linux, OiPer types the transcript with a system tool. Install one of them: wtype,
kwtype, dotool, or ydotool on Wayland, or xdotool or ydotool on X11.
Install the app, then launch it. On first launch you go through first-run setup.
Permissions
On macOS, OiPer asks for four permissions before it can work. All of them are required, and the app shows a permission screen until each one is granted. Grant them from the screen, or later in System Settings → Privacy & Security.
| Permission | Why it is needed |
|---|---|
| Microphone | Records the audio that gets transcribed. |
| Input Monitoring | Detects the global hotkey that starts recording. |
| Accessibility | Inserts the transcribed text into other applications. |
| Screen Recording | Detects the active window's position so the overlay appears in the right place. |
If you grant a permission while OiPer is running and the screen does not update, it re-checks every couple of seconds; quitting and relaunching also works.
Where OiPer stores its files
Everything the app writes lives in one application data directory:
- macOS:
~/Library/Application Support/com.oiper.desktop - Windows:
%APPDATA%\com.oiper.desktop - Linux:
~/.config/com.oiper.desktop
That directory holds config.json, the oiper.db history database, downloaded models
under models/, recorded audio under audio/, and logs under logs/. Deleting the
directory resets the app completely.
Updates
OiPer updates itself from the GitHub release feed. Open Settings, scroll to the About section, and choose Check for Updates. When an update has been downloaded the button becomes Restart to Update; the new version is applied on restart.
OiPer Desktop
OiPer Desktop runs on your machine and types what you say: hold a hotkey, speak, and your words are typed into any app on Windows, macOS or Linux.
Quickstart
Get started with OiPer in minutes: choose how to transcribe, pick text formatting, set your shortcut, and complete your first voice dictation.