Skip to content
peluni
Appearance

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

Permissions peluni asks for
PermissionWhy peluni asksWhat it does with it
MicrophoneTo hear you while you hold the keyRecords into memory only while you hold the key or hands-free dictation is on
AccessibilityTo notice Right ⌥ and Esc, and to paste into the app you're usingWatches 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 peluni keeps, where, and until when
WhatWhereGone when
Recorded audioMemory only, for one dictationIt has been transcribed
Last ten transcriptsMemory onlyYou 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.jsonYou remove the term in Settings → Vocabulary
Settings: cleanup level, models, language, shortcut, paste methodThe com.figge.peluni preferencesYou run defaults delete com.figge.peluni
Log lines: states and lengths, never your wordsmacOS's own system logmacOS 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.