Skip to content
peluni
Appearance

What peluni does

What peluni does once you hold Right ⌥, and the settings that change it. Every setting named here is in peluni's Settings window, under the tab given.

Cleanup levels

Whisper writes down every word you say, false starts included. A small language model running on your Mac then tidies the text before it's pasted. You choose how much it changes in Settings → General → Cleanup level.

Cleanup levels
LevelWhat changes
NoneNothing. You get the raw transcript.
Light (default)Filler words like um and uh go, and punctuation and capitals get fixed.
MediumAlso grammar, and false starts are dropped.
HighAlso sentence structure, and a dictated list becomes a list.

Cleanup never holds up your text. If the model fails, or takes longer than ten seconds, peluni pastes the raw transcript. Its output is checked before it's used: if it comes back more than two and a half times as long as what you said, or under a quarter of it, you get the raw transcript instead.

Dictations under 50 characters skip cleanup and are pasted as transcribed. You can change that number in Settings → Advanced.

The cleanup model is its own download, chosen in Settings → Models: Qwen3 4B (2.3 GB) gives the best results, and Llama 3.2 1B (0.7 GB) is lighter and faster.

Vocabulary

Speech models get names and jargon wrong in predictable ways. In Settings → Vocabulary, you add each term as it should be written, and optionally what it tends to come out as.

  • Every term is passed to whisper as a hint before it transcribes, which nudges it toward your spelling. Cleanup is told to keep these terms exactly as written.
  • Each “sounds like” alias is replaced with its term after transcription, matching whole words and ignoring case. Replacements run in a single pass, so one rule's output is never rewritten by another.

Your list is plain JSON in ~/Library/Application Support/peluni/vocabulary.json, so you can back it up or edit it by hand.

Speech models

peluni transcribes with whisper.cpp on your Mac's GPU. The setup window downloads one speech model, and you can switch any time in Settings → Models. Every model understands several languages.

Speech models
ModelDownloadGood for
Tiny78 MBQuick notes where a wrong word doesn't matter
Base148 MBWhere to start, and the one setup offers
Small488 MBA better balance of accuracy and speed
Medium1.5 GBHigher accuracy, but slower
Large v3 Turbo1.6 GBThe most accurate

Language is set to Auto-detect. If it picks the wrong one, set it to English, Norwegian, Swedish, Danish, German, Spanish or French in the same tab.

Keys and hands-free dictation

Keys
ToPress
Dictate while holdingHold Right ⌥, talk, let go
Dictate hands-freeDouble-tap Right ⌥, then press it once to stop
CancelEsc
Toggle with another shortcutSet one in Settings → General → Shortcuts

If a recording holds less than 0.3 seconds of speech, peluni treats it as an accidental tap and pastes nothing, so brushing the key is harmless.

Pasting and history

peluni pastes into whatever app has your cursor, with the same ⌘V you would use. It saves the text on your clipboard first and puts it back afterwards, unless something else changed the clipboard in the meantime. An image or file you had copied isn't kept.

Some apps refuse pastes from other programs. For those, set Settings → Advanced → Method to Type character-by-character. It's slower, and it gets through.

If peluni can't send the keystrokes at all, your text stays on the clipboard and peluni tells you to press ⌘V. It can't see whether an app took the paste, so if one quietly ignores it, copy the text again from Recent transcripts. In a password field it types nothing; if focus moved into one at the last moment, it puts your clipboard text back.

Your last ten transcripts are in the menu bar menu under Recent transcripts; click one to copy it again. They're kept in memory and never written to disk. peluni has no Dock icon, and Settings → General → Launch peluni at login keeps it ready after a restart.