Contact
To help sort out a problem quickly, include:
- your Mac model, such as MacBook Air (M3)
- your macOS version (Apple menu → About This Mac)
- the Vibecabulary version (select the app in Applications, then File → Get Info)
- what happened, and what you expected to happen
- if it’s about a glossary file, which format it is, and a few lines from it if you can share them
Keyboard shortcuts
| ⌥⌘G | Open or close Vibecabulary from any app |
| type | Live matches on term names, then aliases, then words in the definitions (from 2 letters) |
| ↓ ↑ | Move through results. On an empty field, list every term A–Z, starting from the first (↓) or the last (↑) |
| ⏎ or double-click | Show the definition |
| ⌘C | Copy the term and its definition (when no text is selected in the search field) |
| ⌘, | Settings |
| esc | Clear the field, then go back to recent lookups, then close |
Questions
How do I open Vibecabulary?
Click the {v} in the menu bar, or press ⌥⌘G from any app. The search field is ready for typing as soon as it opens.
Which Macs does it run on?
Any Mac running macOS 14 Sonoma or later. Vibecabulary is built for Apple silicon, and Intel Macs are supported but less tested.
Does Vibecabulary cost anything?
No. It’s free and open source under the MIT license, with no account and nothing to buy. If you’d like to support it, there’s a tip jar.
Can it start when I log in?
Yes. Open Settings (⌘, or the gear in the search bar) and turn on Launch at login.
How do I change the theme?
In Settings, under Theme, pick Reading room, Reading room light, Liquid Glass, Study deck or Midnight aurora. The change shows right away.
What do “N today” and the term of the day mean?
“N today” in the search bar counts the different terms you’ve opened today. It starts again at midnight. The term of the day is picked from your glossary each day and shows when nothing is open.
How do I clear my recent lookups?
In Settings, next to Recent lookups, click Clear.
Your own glossary
Which glossary files can I use?
JSON, CSV or Markdown. Only a term and a definition are required.
- JSON keeps the most: aliases, related terms, tags, sources, citations and notes.
- CSV needs a header row with
term,definition, and can addaliases(separated by semicolons),sourceandcitation. - Markdown uses
## Termheadings with the definition below, or- **Term**: definitionlines. A first line starting with#names the glossary.
How do I switch to my own glossary?
Open Settings, click Choose File… and pick your file. Use Sample Glossary switches back to the study-skills sampler at any time.
I don’t have a glossary yet. Can AI make one?
Yes. Use Make your own glossary on this site, or Make with AI… in Settings. Both give you the same prompt to paste into ChatGPT, Claude, Gemini or another chatbot. It asks for your terms or notes, writes the file and explains how to save it. You can check the file on this site before you open it.
I edited my glossary file. When do the changes show?
The next time you open Vibecabulary. To load them straight away, click Reload in Settings.
Some of my terms are missing.
Entries without both a term and a definition are skipped. In CSV, a definition containing a comma must be wrapped in double quotes. Paste the file into the glossary checker to see which entries can’t be read.
Does Vibecabulary change my glossary file?
Only when you ask it to. The one thing that writes to the file is Save to file under Tag edits, which backs the file up first.
Tags
How do I change a term’s tag?
Open the term and click its colored tag badge, or + Tag if it has none. Choose an existing tag, add a new one or remove it.
Where are my tag changes kept?
In Vibecabulary, separately for each glossary file, so replacing the file doesn’t lose them. In Settings, under Tag edits:
- Save to file writes them into a JSON glossary, after saving a backup copy, and then clears them from the app. CSV and Markdown glossaries keep their tag changes in the app.
- Export… saves them as a separate JSON file.
- Reset discards them.
Uninstalling
How do I quit or uninstall Vibecabulary?
To quit, open Settings and click Quit Vibecabulary. To uninstall, quit it, then drag Vibecabulary from Applications to the Trash.
To remove its saved data too, delete the ~/Library/Application Support/Vibecabulary folder, which holds the sample glossary, your tag changes and backups. Your own glossary files stay wherever you keep them.
Does Vibecabulary collect any data?
No. It doesn’t connect to the internet at all. See the Privacy Policy.