FixesMac6 min read
Aqua Voice not working: offline, terminal, and mic fixes
Aqua Voice not working? Allow HTTPS and WebSockets on port 443, test the mic in Settings > Audio, and use Paste Last Transcript in terminals.
Published by Optimal Apps, the maker of Petal.
On this page
Aqua Voice not working? Find which step fails. If nothing happens at all, check the network first: Aqua's cloud dictation needs an internet connection, and it uses HTTPS and secure WebSockets on port 443, which some corporate proxies block. If the microphone is slow or misses words, open Settings > Audio, choose your microphone, and click Test, then compare with a wired microphone. If the text does not appear in a terminal such as Claude Code, dictate and press Paste Last Transcript. If the text does not appear in Chrome, update Aqua.
These fixes come from Aqua's FAQ, its microphone delay guide, its changelog, and a public GitHub issue.
Aqua Voice not working: quick-fix checklist
| What you see | Likely cause | Fix |
|---|---|---|
| Error or no result on every dictation | No connection, or Aqua service problem | Check the network and status.aquavoice.com |
| Works at home, fails at work | Proxy blocks WSS or inspects TLS on port 443 | Ask IT to allow WSS to the Aqua hosts |
| First words are cut off | Bluetooth microphone switches mode | Test in Settings > Audio, compare with a wired microphone |
| Meter moves, but text arrives late | Network delay | Check connection and service status |
| Wrong microphone, or a virtual input picked | Default input is a virtual device | Select the microphone in Aqua, block the virtual input |
| No text in Claude Code or another terminal | Terminal drops simulated input | Press Paste Last Transcript |
| No text in Chrome web fields | Chromium insertion issue | Update to v0.21.4 or later |
| No text in any app | Accessibility or microphone permission | Reset the permission in System Settings |
Step 1: Check the connection and service status
Aqua's FAQ says, "Cloud dictation needs an internet connection." It also says that offline availability varies by platform, app version, and mode. On a Mac or Windows PC, assume that dictation needs the network unless Aqua support confirms otherwise for your setup.
- Open a web page to confirm that you are online.
- Open status.aquavoice.com and check for an outage.
- Turn off a VPN and test again.
- If you switch between Wi-Fi networks, test on a different network.
If Aqua works on one network and not another, go to Step 2.
Step 2: Allow port 443 and WebSockets on a proxy or firewall
The Aqua FAQ states: "Aqua uses HTTPS and secure WebSockets (WSS) over port 443." It also says that "proxies that block WSS or inspect TLS can cause connection errors." This is the usual cause when Aqua Voice works at home but not at the office.
Send your IT team this request:
- Allow outbound HTTPS and WSS on port 443 to Aqua's hosts. The FAQ names examples such as
api.aquavoice.com,core.aquavoice.com, andrealtime.aquavoice.com, and says this is not a full allowlist. - Allow the WebSocket upgrade for those hosts.
- Turn off TLS inspection for those hosts.
- Ask Aqua support for the full host list for your platform and version.
You cannot fix a corporate proxy from inside the app.
Step 3: Test the microphone in Settings > Audio
Aqua's microphone delay guide gives this order:
- Open Aqua Settings > Audio.
- Select your microphone and choose Test.
- Speak, and note when the input meter starts to move.
What the result means:
- The meter starts late: the delay is in the microphone. Go to Step 4.
- The meter moves fast, but text arrives late: the delay is in the network or the service. Go back to Step 1.
Step 4: Compare Bluetooth with a wired microphone
The FAQ says, "Bluetooth microphone mode switching can add delay." A Bluetooth headset changes to a different mode when its microphone starts, and the first words can be lost.
- Say the same short sentence with your Bluetooth headset, the built-in microphone, and a wired microphone, if you have one.
- Repeat after the microphone was idle for a while, because the delay is often worse at the first use.
- If only Bluetooth is slow, use the built-in or a wired microphone for dictation. Aqua's FAQ gives the same advice for AirPods.
For general headset fixes on a Mac, read Bluetooth microphone dictation on Mac.
Step 5: Select the correct input
- In Aqua, select the microphone you want instead of relying on the system default.
- Check the microphone's mute switch.
- Open System Settings > Privacy & Security > Microphone on a Mac and make sure Aqua Voice is on.
- If you use audio routing software, such as BlackHole, it can become the default input. Aqua's changelog (v0.19.12) says you can block virtual inputs so Aqua picks a real microphone.
Step 6: Aqua Voice not pasting in a terminal or Claude Code
GitHub issue #51725 on the anthropics/claude-code repository describes Aqua Voice text that was silently dropped in the Claude Code prompt. The report came from Windows 11, with Aqua v0.14.2 in the Cursor integrated terminal. The reporter's theory was that Aqua inserted text with simulated keystrokes, which Claude Code did not accept. The clipboard-based Paste Last Transcript worked.
- Dictate as usual.
- If no text appears, press Paste Last Transcript. Aqua's changelog gives the default as Control-Command-V on Mac and Control-Shift-Right Arrow on Windows.
- To change the shortcut, open Aqua Settings > Keybindings. You can also bind it to a mouse button.
This adds one key press for each dictation. For other terminal and editor fixes, read Dictation not pasting into VS Code, Terminal, or Claude Code.
Step 7: Aqua Voice not pasting in Chrome
Aqua's changelog for v0.21.4 (October 2026) says it improved text insertion in Chrome and other Chromium apps on Mac, for the case where a finished dictation does not appear in the field. An earlier release, v0.11.6, fixed a paste bug in VS Code and Cursor.
- Update Aqua to the latest version.
- Test the web field again.
- If it still fails, press Paste Last Transcript.
Step 8: Reset permissions
If text does not appear in any app on a Mac:
- Open System Settings > Privacy & Security > Accessibility.
- Turn Aqua Voice off and on. If that does not help, remove it with the minus button and add it again.
- Do the same in Privacy & Security > Microphone.
- Quit Aqua and open it again.
Full steps are in Accessibility permission not working after an app update.
Step 9: Contact Aqua support
The Aqua FAQ asks you to report the app name and version for fields that do not work. For microphone delay, the guide asks for your operating system, Aqua version, microphone model, connection type, and when the delay happens (during the microphone test, at the start of a recording, or after you finish speaking).
When you need dictation that works offline: Petal
Aqua Voice is a capable cloud dictation app, and many of the problems above are network problems by design: a cloud service needs a working connection and an open path through your firewall. If you dictate on flights, on locked-down office networks, or with private material, an on-device app avoids that class of problem.
Petal for macOS is free and open source (MIT):
- Speech runs on your Mac. Choose a model such as Parakeet, Whisper Large V3 Turbo, or Qwen3-ASR. After the download, dictation needs no network, no account, and no proxy rule.
- Cleanup on your Mac too. Petal W1, an on-device model, removes fillers and fixes punctuation. A cloud model with your own key is optional.
- A clipboard paste. Petal sends Command-V and restores your old clipboard after 700 ms, which helps in VS Code and terminals.
- Per-app Router. Set a terminal to As Said and Mail to Email.
Petal does not have every Aqua feature, for example Aqua's Notetaker. For a full comparison, read Aqua Voice alternative.
Questions
Does Aqua Voice work offline?
Aqua's FAQ says cloud dictation needs an internet connection and that offline availability varies by platform, app version, and mode. On a desktop without a connection, expect cloud dictation to fail. Ask Aqua support what your setup supports.
Why does Aqua Voice not work on my work network?
Aqua uses HTTPS and secure WebSockets (WSS) over port 443. Its FAQ says proxies that block WSS or inspect TLS can cause connection errors. Ask your IT team to allow WSS to the Aqua hosts and to skip TLS inspection for them.
Why is Aqua Voice not pasting in Claude Code or a terminal?
GitHub issue #51725 reports that Aqua text was silently dropped in Claude Code on Windows, while Paste Last Transcript worked. Dictate, then press Paste Last Transcript (Control-Command-V on Mac by default).
Why does Aqua Voice miss my first words?
Aqua's guide says Bluetooth microphones can take time to switch to their microphone mode. Test the microphone in Settings > Audio, and compare a Bluetooth headset with the built-in or a wired microphone.
Is there an offline alternative to Aqua Voice for Mac?
Petal for macOS is free and open source. It runs speech models on your Mac, so dictation works with no network after the model download.