Security
peluni needs two permissions worth thinking about before you grant them: one lets it hear you, the other lets it type into other apps. This page says what it does with each, and how to report a problem.
What the permissions are for
| Permission | Why peluni asks | What it does with it |
|---|---|---|
| Microphone | To hear you while you hold the key | Records into memory only while you hold the key or hands-free dictation is on |
| Accessibility | To notice Right ⌥ and Esc, and to paste into the app you're using | Watches for its keys anywhere on your Mac, sends ⌘V (or types the text) into the focused app, and checks whether the focused field is a password field |
With the experimental Autocomplete switch on, peluni also reads up to 400 characters before your cursor to work on a suggestion, on your Mac, though it shows no suggestions yet. It's off unless you turn it on.
Why peluni isn't sandboxed
The macOS sandbox would stop peluni from pasting into other apps, so it runs outside it. Its only entitlement is audio input. That makes the permissions above the real boundary, which is why the source is public: you can read exactly what it does with them.
Password fields
Before pasting, peluni asks macOS whether the focused element is a secure text field, and asks again just before the paste lands, in case focus moved. If it is, peluni pastes nothing. If focus moved into it at the last moment, after the transcript was already on the clipboard, peluni puts your clipboard text back. The experimental Autocomplete switch never reads a secure field either.
What stays on your Mac
| What | Where | Gone when |
|---|---|---|
| Recorded audio | Memory only, for one dictation | It has been transcribed |
| Last ten transcripts | Memory only | You quit peluni |
| Speech models | ~/Library/Application Support/peluni/Models/whisper/ | You click the trash button beside one in Settings → Models |
| Cleanup models, and the experimental autocomplete model | ~/Library/Application Support/peluni/Models/llm/ | You delete the folder; Settings has no button for these yet |
| Vocabulary: each term and what it sounds like | ~/Library/Application Support/peluni/vocabulary.json | You remove the term in Settings → Vocabulary |
| Settings: cleanup level, models, language, shortcut, paste method | The com.figge.peluni preferences | You run defaults delete com.figge.peluni |
| Log lines: states and lengths, never your words | macOS's own system log | macOS clears old entries on its own schedule |
To remove all of it, quit peluni, delete it from Applications, delete ~/Library/Application Support/peluni/, and run defaults delete com.figge.peluni in Terminal.
Network
The app connects to huggingface.co over HTTPS to download a model when you press Download, and to nothing else. It has no update checker.
To check this yourself, open Terminal while peluni is running, run nettop -m tcp -p $(pgrep -x peluni) and dictate a few sentences. With the models downloaded, no connection appears.
Signed builds
No release has been published yet. A build you make with make run is signed with a certificate created on your own Mac, so macOS keeps its permissions between builds. For releases, the release script signs with a Developer ID, turns on the hardened runtime and has Apple notarize the build, and it stops if any of those checks fails.
Reporting a vulnerability
Report it privately through GitHub's vulnerability reporting, not in a public issue. Reports go to Fredrik Haugen, who maintains peluni.