Hlas documentation
A little setup.
A lot less typing.
New to voice typing? Start here. We’ll walk through installing Hlas, giving it permission to hear you, and turning your first sentence into text. You don’t need to understand AI or change every setting.
Fully local, from speech to finished text. Choose a local speech model and your audio stays on your Mac. AI cleanup runs locally too. Download your models once, then use them offline.
Start with one small task
Follow sections 1 and 2 to write a sentence in Notes. Once that works, try cleanup, translation, or meetings when you need them.
What Hlas does: you speak, stop recording, and Hlas turns your speech into written words. This is called dictation. It listens when you start a recording, not continuously in the background.
How to read this guide: “Settings → General” means open Hlas’s Settings window, then click General on the left. A shortcut or hotkey is a combination of keyboard keys you press together.
1. Set up Hlas
You’ll need an Apple Silicon Mac (M1 or newer) with macOS 14 Sonoma or later. Meeting recording requires macOS 14.4+; Apple Translation requires macOS 15+.
To check your Mac, click the Apple menu in the top-left corner of your screen, then About This Mac. Look for an Apple M-series chip and the macOS version.
Step 1. Download and install
- Download the app. Click Download Hlas. Wait for your browser to finish downloading a file named Hlas.dmg. A DMG is a Mac installation file.
- Open the downloaded file. In Finder, choose Downloads in the left sidebar, then double-click Hlas.dmg. This opens the installer.
- Copy Hlas into Applications. Drag the Hlas app onto the Applications folder in the installer. If you don’t see an Applications shortcut, open Applications in a second Finder window and drag Hlas there. Wait for copying to finish.
- Open your installed copy. In Finder, click Applications and double-click Hlas. If macOS asks whether you want to open an app downloaded from the internet, check that it is Hlas and choose Open.
Step 2. Find Hlas in the menu bar
The menu bar is the thin strip across the top of your Mac’s screen, near the clock and Wi-Fi icon. Hlas appears there as a small microphone. It does not have an icon in the Dock along the bottom of the screen.
Click the microphone once to open Hlas’s small control panel. To open the app menu, right-click the microphone. On a trackpad, click with two fingers; you can also hold the Control key while clicking. Choose Settings in that menu whenever this guide refers to Hlas Settings.
Step 3. Complete the setup assistant
The first time you open Hlas, a small welcome panel walks you through setup. Click Continue to move between its screens. You can use Back if you want to change a choice.
- Microphone Access: when macOS asks to let Hlas use the microphone, allow access. Hlas needs this to hear your voice. The setup panel should then say Permission granted.
- Accessibility Access: click Open System Settings if access is not already granted. In the Accessibility list, find Hlas and turn its switch on. Your Mac may ask you to unlock the setting. Return to Hlas by clicking its menu bar microphone. This permission lets Hlas paste words into your other apps; it does not mean you need to use accessibility features yourself.
- Choose Your Engine: an engine is the part that recognizes speech. The assistant recommends Local Parakeet v3 for its supported European languages. Choose WhisperKit if you need its wider language selection. Both work on your Mac. You can change this later.
- Wait for the download. A model is the file the app needs to recognize speech. It is downloaded once, then kept on your Mac. You can continue through setup while it downloads, but wait until it is ready before your first recording.
- Set Your Hotkey: keep the default ⌘ Shift Space for now. Choose Toggle if you prefer pressing once to start and again to stop, or Push-to-talk if you prefer holding the keys while speaking. Click Get Started.
You’re ready when: setup is finished, the speech model is no longer downloading or loading, and Hlas shows a green ready indicator. The first setup takes longer than later launches.
What the permissions are for
| Permission | Why Hlas needs it |
|---|---|
| Microphone | Record your voice. |
| Accessibility | Paste the transcript into your active app. |
| System Audio Recording | Include the other side of a meeting. Needed when capturing system audio. |
| Calendars | Find matching events for meeting reminders. Optional. |
Manage access in System Settings → Privacy & Security. To repeat setup, open Hlas Settings → Advanced → Show Setup Assistant.
2. Dictate your first text
Try this in a blank note first. You’ll know the basics are working before using Hlas for an email or message.
- Open Notes and create a new note. Click in the note’s writing area. You should see a blinking vertical line—this is your cursor, and it marks where the words will appear.
- Start recording. Hold down the Command key (⌘) and Shift, then press the Space bar. In Toggle mode, release all three keys and start talking. In Push-to-talk mode, keep holding the shortcut while you talk.
- Say a short sentence. For example: “Remember to buy milk on the way home.” Speak at a normal pace. You don’t need to read out each letter.
- Stop recording. In Toggle mode, press ⌘ Shift Space again. In Push-to-talk mode, release the keys.
- Wait for your words. Hlas processes the recording after you stop. Your text should appear in the note when auto-insert is on; it does not need to appear word by word as you speak.
- Read and correct the result. Click into the text and edit it just as you would something you typed. Voice recognition can make mistakes, especially with names.
Expected result: your sentence appears in Notes. If you can see the transcript in Hlas but not in Notes, check the auto-insert steps below.
Choose how you record
- Push-to-talk: hold the shortcut while speaking, then release to finish.
- Toggle: press once to start and again to stop.
- Cancel: press Esc during dictation to discard the take.
Change the shortcut and recording mode in Settings → General. Click the menu bar icon for recording controls; right-click it for Settings, History, updates, and Quit.
Choose whether text is pasted automatically
- Right-click the Hlas microphone and choose Settings.
- Click General on the left.
- Find Text Insertion and turn on Auto-insert transcribed text.
- Leave Press Enter after inserting off while learning. This lets you review a message before sending it.
- Click back into your note before starting another dictation.
Make it fit your workflow
Auto-insert transcribed text pastes into your active app and restores the previous clipboard afterward. Turn it off to copy the result yourself. Press Enter after inserting is a separate, optional setting: it can send a message immediately in chat apps.
For feedback without opening the popover, enable Show on-screen recording indicator or Play sound cues in General. You can drag the floating indicator to a convenient spot.
3. Models & languages
You can leave your first model selected if it works well. Change it when you need a different language or want to try another balance of speed and accuracy.
- Right-click the microphone, choose Settings, then click Transcription.
- Under Transcription Backend, select Local (WhisperKit) or Local (Parakeet). “Local” means the recording is processed on your own Mac.
- With WhisperKit, choose a model and click Download if it is not already downloaded, or Select if it is. Base is a small starting option. With local Parakeet, let its model finish downloading and preparing.
- Wait for loading to finish, then try the same short sentence in Notes again.
| Option | What it offers | Where audio goes |
|---|---|---|
| Local (WhisperKit) | Broad language support, several model sizes, and translation to English. Base (~140 MB) is the default model. | Stays on your Mac. |
| Local (Parakeet) | Parakeet v3, optimized for Apple Silicon. Automatically recognizes 25 European languages. | Stays on your Mac. |
| Remote (Parakeet) | An advanced option using your own server. | Sent to the server you configure. |
A language setting describes the language you are speaking; it does not translate your words. With WhisperKit, use the Language controls in Transcription settings to choose it. Automatic detection means Hlas tries to work it out for each recording. Local Parakeet detects its supported languages automatically.
Larger Whisper models use more disk space and take longer to load. Models are cached, so you don’t download them for each session.
Optional: connect your own server
Set up a Hlas Parakeet server, select Remote (Parakeet), enter its address, and click Test. This mode needs a network connection and uploads dictation audio to that server. Plain HTTP does not encrypt the connection. Meeting transcription still uses a local WhisperKit model.
4. Clean up your text
AI cleanup is an extra step that rewrites spoken wording into cleaner text. Basic dictation works without it. Start with this feature only after your first dictation works.
- Right-click the microphone, open Settings, and click Text.
- Find the AI Cleanup section and turn on Clean up transcripts with S1-mini.
- Allow its separate model download to finish (about 350 MB). If you see a Download or Retry button, use it and wait until the model is ready.
- Choose a tone. Casual suits informal wording; formal suits more formal writing. You can leave the default tone while trying it. Keep the list and email options off for your first test.
- Return to Notes and dictate the example below. Compare the result with what you said.
“S1-mini” by “Superwhisper” runs on your Mac. It removes fillers, resolves spoken corrections, adds punctuation, and formats spoken numbers and addresses.
You say: “Let’s meet on Friday, no, Thursday at two thirty.”
Example result: “Let’s meet on Thursday at 2:30.”
- Tone: casual, semi-casual, semi-formal, or formal.
- Allow bullet lists: format three or more listed items as Markdown bullets.
- Format as email: arrange a greeting, body, and sign-off.
AI cleanup supports English text and is not applied to meeting recordings. If the cleanup model is unavailable or cannot produce a usable result, Hlas keeps the transcript without the AI rewrite.
Keep checking the meaning. Cleanup can change wording, not just spelling. If you prefer the original wording, turn the cleanup switch off and dictate again.
Teach Hlas a name it keeps getting wrong
- In Settings → Text, find Personal Dictionary and turn on Enable personal dictionary.
- Click the + below the list to add an entry.
- Enter the word Hlas wrote incorrectly and the spelling you want it to use instead. For example, replace “glass” with “Hlas” only if that is a correction you want applied.
- Try a new dictation containing that name. Dictionary entries affect later processing; they don’t rewrite earlier saved transcripts.
Simple text rules without AI cleanup
Dictionary replacements and any translation run before AI cleanup.
Without AI cleanup, you can enable Remove filler words for English fillers, and Smart punctuation for basic capitalization and a final period. Those two rules are disabled while AI cleanup is active.
5. Translation
Translation lets you speak in one language and receive written text in another. The target language is the language you want to write in.
- Open Hlas Settings and click Translation.
- Turn translation on and choose your target language—for example, English if you want English text.
- If asked to download a language pack, let it finish while connected to the internet. This file lets the translation work on your Mac.
- Return to your note and dictate one sentence in your spoken language. After you stop, check that the result is in your chosen target language.
- Turn translation off when you want to write in the language you are speaking again.
- WhisperKit to English: uses Whisper’s built-in English translation.
- Apple Translation: supports translation with either local engine on macOS 15+. Download any requested language packs before using it offline.
If automatic language detection gives unexpected results, choose your spoken language in Transcription settings. Available translation languages depend on Apple’s installed language support.
6. Record meetings
A meeting recording is different from a short dictation: you start it at the beginning of a call and stop it at the end. Hlas creates the written transcript afterward. It does not need a meeting bot to join the call.
Microphone audio means your voice. System audio means sound playing through your Mac, including the other people on a call and other playing media. On macOS 14.4+, Hlas can record both together.
Before your first full meeting, make a short test recording so you can check that both sides are captured.
- In Settings → Meetings, choose whether to capture system audio, your microphone, or both.
- Join your call as usual. Click the Hlas microphone in the menu bar, then use its meeting recording control (separate from the dictation microphone). You can also use the meeting recording item in the right-click menu. If macOS asks for System Audio Recording access, allow it to include sound from the call. Check that the meeting elapsed-time display starts.
- At the end, use the same meeting control to stop. Hlas combines the recorded sound and converts it into text locally. Leave Hlas open while it processes; a long recording takes longer than a short dictation.
- Open History to read the transcript. Keep Save transcripts to History enabled in Advanced settings to retain it.
Meeting transcripts are never pasted into another app automatically. You can dictate while a meeting is recording; dictation pauses while the finished meeting is being mixed or transcribed. If meeting transcription fails, use Retry in the popover.
Set up a reminder for a meeting
- Open Settings → Meetings and turn on Enable calendar reminders.
- Allow Calendar access and notifications when prompted. If access was previously denied, use the settings controls to open the relevant macOS permission page.
- Select the calendars that contain your meetings. If none appear, check that they are available in your Mac’s Calendar app.
- For a first test, leave title filters empty and the video-link requirement off. More filters mean fewer events will match.
- Keep Hlas running. When a matching event begins, use the reminder to start recording.
Optional reminder filters and automatic recording
In Meetings settings, enable reminders, grant Calendar access, and select the calendars to watch. Optionally filter by words in the event title or require a Zoom, Google Meet, Teams, or Webex link.
Start meeting recording automatically adds a cancellable 10-second countdown when a matching event begins. Hlas must be running. You can assign a separate meeting recording shortcut in General settings.
7. History & privacy
History is the list of transcripts Hlas has saved on this Mac. It helps you find a previous dictation or read a meeting after it finishes.
- Right-click the Hlas microphone and choose History.
- Click a transcript to select it. Use the search field to look for a word, or choose the Meeting filter to narrow the list to meetings.
- Right-click an entry to open its menu. Choose Copy to put its text on the clipboard, then click in your destination document and press ⌘ V to paste.
- Choose Export if you want a separate file. Pick a name and location in the save window.
If History is empty, open Settings → Advanced and check Save transcripts to History. Turning it on saves future transcripts; it won’t recreate earlier unsaved recordings.
In Settings → Advanced, choose whether to save transcripts and how long to keep them. Retention removes older entries automatically. Deleting or clearing History permanently removes the selected saved transcripts.
What stays local
Local speech recognition, AI cleanup, and transcript history stay on your Mac. Dictation audio files are temporary. Meeting audio is retained if transcription fails so you can retry; it is removed after successful transcription.
Internet access is used for model downloads and update checks. Optional remote transcription sends audio to your configured server. Once text is inserted into another app, that app’s own storage and syncing settings apply.
8. Settings at a glance
| Pane | What you can change |
|---|---|
| General | Launch at login, shortcuts, recording mode, auto-insert, Enter after inserting, recording indicator, sound cues. |
| Transcription | Local or remote processing, speech models, downloads, language, server connection. |
| Translation | Translation and target language. |
| Text | AI cleanup, tone, lists, email formatting, filler words, punctuation, personal dictionary. |
| Meetings | Audio sources, calendar reminders, event filters, automatic recording. Requires macOS 14.4+. |
| Advanced | History retention, permissions, setup assistant, debug logging. |
To check for a new version, right-click the Hlas menu bar icon and choose Check for Updates.
9. Troubleshooting
I can’t find Hlas after opening it
Look for the microphone at the top of your screen. There is no Dock icon. A crowded menu bar can hide it; make room among your other menu bar items.
Recording works, but no text appears
- Click the Hlas microphone and see whether the latest transcript is visible. If it is, speech recognition worked.
- Open Hlas Settings → General and turn on Auto-insert transcribed text.
- Open your Mac’s System Settings → Privacy & Security → Accessibility. Find Hlas and check that its switch is on.
- Return to Notes, click in the note’s writing area, and try another short dictation.
- For now, you can use Copy on the latest Hlas result and paste it into Notes with ⌘ V.
Hlas says “Nothing heard”
- Open System Settings → Sound → Input and select the microphone you intend to use. If using headphones, check they are connected.
- Speak and check whether the input level moves.
- In Privacy & Security → Microphone, make sure Hlas is allowed.
- Return to Hlas and record a short sentence at a normal speaking volume.
A model is taking a long time to load
The first load of a large Whisper model can take 60–90 seconds while CoreML initializes. Wait for the ready indicator. If loading fails, use Retry or Redownload in Transcription settings and check your internet connection.
The meeting has only my voice, or no sound
Enable system audio capture in Meetings settings and check System Settings → Privacy & Security → Screen & System Audio Recording. Confirm that your meeting app is playing audio before trying another recording.
AI cleanup doesn’t change my text
Confirm that cleanup is enabled and its model has downloaded in Settings → Text. It works on English dictation, not meeting transcripts. If cleanup fails or times out, Hlas keeps the text without the rewrite.
Permissions stopped working after an update
Open Settings → Advanced → Show Setup Assistant to repeat the checks. Use the permission controls there to open the relevant System Settings pane.
My keyboard shortcut doesn’t start recording
First check that Hlas is running and its microphone is visible in the menu bar. Right-click it, open Settings → General, and look at Recording shortcut. Use the keys shown there—your shortcut may have been changed from the default. Check the selected recording mode too: Push-to-talk requires you to keep holding the keys. If another app uses the same shortcut, click the shortcut control and record a different combination.
Where do I open settings: in Hlas or in macOS?
Hlas Settings controls things like models and recording mode: right-click the microphone in the menu bar and choose Settings. System Settings is Apple’s app for your Mac: open the Apple menu at the top left, then choose System Settings. You use that for microphone, Accessibility, and system audio permissions.
I need more help
Enable debug logging in Settings → Advanced, reproduce the problem, and use Reveal Log in Finder. Logs are stored at ~/Library/Logs/Hlas/debug.log. Contact davidbudac@gmail.com with your macOS version, Hlas version, and the steps that reproduce the issue.