User guide

How every part of Jibber-Jabber works. New to it? Start with the Setup guide to install it and add your key, then come back here.

The floating button

The floating button sits on top of your other windows so you can always see what Jibber-Jabber is doing. It never takes the keyboard away from the app you're typing in.

The floating Jibber-Jabber bar, ready, with the mic button, a make-small button and a more-options buttonThe floating Jibber-Jabber bar, ready, with the mic button, a make-small button and a more-options button
Ready
The floating button shrunk to a small round micThe floating button shrunk to a small round mic
Small round mic

The floating button's menu

Right-click the floating button, or click its three dots, for quick access to the things you change most, without opening the main window. Greyed-out items aren't available just then: Cancel only works while you're dictating, and the last-text items need a dictation first.

Settings items on the menu wait while you're dictating, just like the Settings tab.

What the colours mean

The floating bar while listening, with a live sound wave and Let go to finishThe floating bar while listening, with a live sound wave and Let go to finish
Listening: blue, with your voice level
The floating bar showing Done and Your text is inThe floating bar showing Done and Your text is in
Done: green, your text is in
The floating bar in amber with a warning sign, saying Inserted without tidy-upThe floating bar in amber with a warning sign, saying Inserted without tidy-up
Needs a look: amber with a warning sign

Amber never means your words are lost. The bar says what happened, and the main window explains more. See Messages and what to do.

Dictating

First click where you want the words: an email, a document, a chat, a form or a Remote Desktop window. Then use whichever way suits you:

Your words go into the window you were in when you started, even if you click somewhere else while they're being written up. Whatever you had copied is put back afterwards.

Laying out your text by voice

Say these on their own, with a short pause before and after, in any writing style:

The same words inside a sentence, such as "a new line of credit", are left alone.

Your text (the Home tab)

The main window keeps your latest dictation, so you can copy it again or fix a word. Open it from the tray icon or the floating button's menu.

The Home tab showing Done, Your text with the tidied-up sentence, and Copy, Clear and Bigger boxThe Home tab showing Done, Your text with the tidied-up sentence, and Copy, Clear and Bigger box
Just after a dictation

Compare with what you said

Open Compare with what you said to see your exact words next to the tidied-up version. Choose Use what I said to switch back to your words, or Use tidied-up to switch again. Switching doesn't send anything or cost anything.

The Home tab with Compare with what you said open, showing What you said with ums and ahs, and the Tidied up versionThe Home tab with Compare with what you said open, showing What you said with ums and ahs, and the Tidied up version
Your words and the tidied-up version, side by side

The pop-up holding your text

If your text couldn't be pasted safely (you switched windows, the box was a password field, or the window runs as administrator), a small pop-up appears near the pointer with the reason and your text.

The pop-up titled Here is your text, saying You switched windows, so nothing was pasted, with Discard, Copy and Insert here buttonsThe pop-up titled Here is your text, saying You switched windows, so nothing was pasted, with Discard, Copy and Insert here buttons
Nothing is lost: your text waits here

Closing the pop-up keeps your text in the main window. Starting a new dictation hides it.

Writing styles compared

Choose a style in Settings, Dictating. Here's the same short dictation in each one:

As spoken

Exactly what you said. No tidy-up, so it's the fastest and costs least.

um hi Sam just following up on the quote for the bathroom uh can you let me know if Tuesday still works and um whether the tiles have arrived thanks

Light tidy-up

Fixes punctuation, capitals and slips, and removes ums and ahs. Your wording stays.

Hi Sam, just following up on the quote for the bathroom. Can you let me know if Tuesday still works and whether the tiles have arrived? Thanks.

Polished

Rewrites like an editor, clear and professional, without adding anything you didn't say.

Hi Sam,

I'm following up on the quote for the bathroom. Could you let me know whether Tuesday still works, and whether the tiles have arrived?

Thanks

These are examples. Real results vary a little each time.

Settings, section by section

Settings opens with every section closed and a one-line summary of each. Open one to change it; opening another closes the last. Changes apply from your next dictation, and Settings waits while you're dictating.

The Settings tab with each section closed: Dictating, Words to keep exactly, Floating button, OpenAI connection, Claude connection and AppThe Settings tab with each section closed: Dictating, Words to keep exactly, Floating button, OpenAI connection, Claude connection and App
Every section closed, with a summary of each

Dictating

The Dictating section: Microphone, Writing style, Tidy-up by, Add paragraphs automatically, Paste where I was typing, Hold Right Ctrl to talk and the Start/stop shortcutThe Dictating section: Microphone, Writing style, Tidy-up by, Add paragraphs automatically, Paste where I was typing, Hold Right Ctrl to talk and the Start/stop shortcut

Words to keep exactly

The Words to keep exactly section, with three example words, one per lineThe Words to keep exactly section, with three example words, one per line

Add names, products and terms you use often, one per line (up to 128). The tidy-up never changes them and uses your spelling as a guide. They're only a guide for tidy-up: if a name is often heard wrongly, saying it clearly helps most.

Floating button

The Floating button section: Show the floating button, Use the small round mic between dictations, Show the microphone level while listening, and Reset its positionThe Floating button section: Show the floating button, Use the small round mic between dictations, Show the microphone level while listening, and Reset its position

OpenAI connection

The OpenAI connection section showing Connected, a key hidden as dots, and Save key, Check connection and Remove keyThe OpenAI connection section showing Connected, a key hidden as dots, and Save key, Check connection and Remove key

Claude connection (optional)

The Claude connection section, not set up, with a Claude API key box and Save key, Check connection and Remove keyThe Claude connection section, not set up, with a Claude API key box and Save key, Check connection and Remove key

Only needed if you choose a Claude model under Tidy-up by. It works the same way as the OpenAI connection, with a key from console.anthropic.com.

App

The App section: Start Jibber-Jabber when I sign in to Windows, Theme, the version with Copy version, Check for updates automatically, Check for updates, and Chip inThe App section: Start Jibber-Jabber when I sign in to Windows, Theme, the version with Copy version, Check for updates automatically, Check for updates, and Chip in

Closing the main window keeps Jibber-Jabber running in the tray. To quit, use Exit in the tray menu.

The tray icon

Jibber-Jabber lives in the system tray, near the clock (you may need the small arrow to see it). Its icon changes while you're recording and when something needs a look. Double-click it to open the main window, or right-click for:

Messages and what to do

When something needs your attention, the floating button and the top of the main window turn amber and say what happened.

The Home tab with an amber box saying Inserted without tidy-up, and the words as spoken belowThe Home tab with an amber box saying Inserted without tidy-up, and the words as spoken below
An amber message, with your words kept underneath
Inserted without tidy-up
Your words went in as you said them. Usually the tidy-up service was slow or unavailable, or a tidy-up would have changed names, numbers, codes or your Words to keep. Fix it by hand or dictate again.
Here is your text
It couldn't be pasted safely. Use the pop-up to insert or copy it.
Check the remote window
A Remote Desktop session didn't take the text, so clipboard sharing may be off for it. If something else was pasted, press Ctrl+Z.
Clipboard not restored
Your text is in, but what you had copied before (often a picture or files) couldn't be put back exactly.
Didn't catch that
No speech was recorded, so nothing was sent. Check the microphone in Settings, Dictating.
Choose a microphone
Pick one in Settings, Dictating, or plug one in and choose Refresh.
Microphone access is blocked
Allow microphone access for desktop apps in Windows Settings, Privacy and security, Microphone.
Connect to OpenAI
No OpenAI key is saved yet. See the Setup guide.
Tidy-up model changed
The model you chose has been retired, so another one tidied your text. Choose a different one under Tidy-up by.
Update Jibber-Jabber
OpenAI retired the speech-to-text model this version uses. Use Check for updates in Settings, App, then Restart.
10-minute limit reached
Recording stopped at 10 minutes. Your words were kept and written up.
Shortcut unavailable
Another app uses that shortcut. Choose a different one in Settings, Dictating.

The Help tab

The same guidance, in short, is built into the app and works offline: open the Help tab, or choose Help from the tray icon. It shows your own shortcut. For a printable one-page summary, see the Quick start (PDF).

The Help tab with Getting started open and topics from Starting and stopping to LicencesThe Help tab with Getting started open and topics from Starting and stopping to Licences
Help inside the app

Remote Desktop, privacy and costs

Still stuck? Email hello@jibber-jabber.com.au.