Troubleshooting
Start with Avette Settings → Help (Setup & Help in the ? menu of Avette's window opens it there). Its first rows show the speech model (Pack), Microphone access, Accessibility access and Avette Input, with a button next to anything that needs fixing. Your license is in Avette Settings → License.
Nothing happens when I press the dictation key
- Setup isn't finished. While a permission or Avette Input is missing, setup opens on that step each time Avette starts. Avette Settings → Help → Run setup again opens it any time.
- You haven't logged out since setup turned on Avette Input. macOS gives a new input method only to apps started after you log in, so Avette doesn't dictate until you log out and back in.
- The speech model is still downloading or loading. The Pack row in Avette Settings → Help shows its progress.
- No license yet. Avette dictates only into its Scratchpad until you enter a key in Avette Settings → License.
- The cursor is in a password field. Avette won't dictate there.
Don't look for Avette Input in System Settings → Keyboard → Input Sources or in the menu bar's input menu: it never appears there, even when it's on and working, and adding or removing input sources there does nothing for Avette. To see whether macOS has it turned on, paste this into Terminal (it only reads):
defaults read com.apple.inputsources AppleEnabledThirdPartyInputSources
If Avette Input is on, the list includes eu.avette.inputmethod.Avette.
Avette dictates, but one app gets nothing
Words that couldn't reach the field are in the Scratchpad, in Avette's window.
- Click another app, then back into the field.
- In Avette Settings, search for typing: under Avette isn't typing into an app, press Reconnect, then click into the field again.
- Quit and reopen that app.
- Log out and back in.
Setup is stuck on "Turn on Avette Input"
If setup shows a Terminal command, paste it into Terminal, then press Check again. If setup still says Avette Input is off, restart Avette (Avette Settings → Help → Restart Avette): setup opens again on the step you were on.
Still stuck? Use Export diagnostics in Avette Settings → Help and email the file to avette@bearcove.eu. It has the log, this Mac's setup, audio devices and Avette's settings; dictated text is redacted.
It's using the wrong microphone
Avette picks from its own list in Avette Settings → Audio, not from System Settings → Sound. Drag the microphone you want to the top. See Dictating.
The speech model won't download or load
Avette downloads the model as soon as it opens, and an interrupted download picks up where it stopped when Avette opens again. Check your connection, then restart Avette, or press Retry if Avette Settings → Help shows an error next to Pack.
My license won't activate
- Paste the key rather than typing it.
- "This license has no seats left. Deactivate another device first.": a license covers up to 15 devices. Free one with Deactivate this Mac… in Avette Settings → License on a Mac you no longer use, or Reset all activations from any activated Mac.
- "Can’t verify your license offline. Connect to the internet.": Avette checks your license when it opens and works offline for up to 7 days after the last successful check. Connect to the internet and open Avette again.
Something else
Restart Avette (Avette Settings → Help → Restart Avette). If that doesn't help, email avette@bearcove.eu, with the file from Export diagnostics if you can.