CSV format (iOS)
On iOS, vocabulary is exported and imported as a plain CSV file. Each row represents one entry:
The parser follows RFC 4180: fields that contain commas, quotes, or newlines must be wrapped in double-quotes, and a literal double-quote inside a quoted field is escaped as
"". LF, CR, and CRLF line endings are all accepted.
Example:
Export CSV (iOS)
1
Open the Vocabulary screen
Go to Vocabulary in the app.
2
Open the actions menu
Tap the ⋯ button in the top-right corner.
3
Tap Export CSV
Your vocabulary is saved as a
.csv file via the system share sheet.Import CSV (iOS)
1
Open the Vocabulary screen
Go to Vocabulary in the app.
2
Open the actions menu
Tap the ⋯ button in the top-right corner.
3
Tap Import CSV
Pick a
.csv file from Files. The app shows a summary: how many entries were imported and how many were skipped..hwbackup.json format (macOS and Windows)
macOS and Windows share a universal backup format (schemaVersion: 2). The vocabulary section of a .hwbackup.json file looks like this:
The
.hwbackup.json file can also contain settings, modes, and API keys—not just vocabulary. The vocabulary-only export on macOS produces a file with five top-level keys (schemaVersion, exportDate, appVersion, platform, vocabulary) but no settings, modes, or API keys sections. When you import this file on either platform, only the vocabulary section is applied.Export vocabulary (macOS)
1
Open Settings
Click the HyperWhisper menu bar icon and choose Settings.
2
Go to Backup
Select the Backup tab.
3
Select Vocabulary and export
Tick the Vocabulary section (you can deselect everything else to get a vocabulary-only file), then click Export. Save the file—it will be named
HyperWhisper Vocabulary YYYY-MM-DD.hwbackup.json when vocabulary is the only selected section.Import vocabulary (macOS)
1
Open Settings → Backup
Click the HyperWhisper menu bar icon, choose Settings, then select the Backup tab.
2
Choose a file
Click Import and pick your
.hwbackup.json file. The app shows the vocabulary entry count from the file.3
Select Vocabulary and choose a conflict policy
Tick Vocabulary and pick how to handle entries whose word already exists in your list:
- Skip existing (default) — leaves your current entry untouched.
- Replace existing — overwrites the replacement text of the matching entry.
4
Apply the import
Click Import. The app reports how many entries were imported and how many were skipped.
Export vocabulary (Windows)
1
Open Settings → Backup
Open HyperWhisper and go to Settings → Backup.
2
Select sections and export
Tick Vocabulary (and any other sections you want to include), then click Export. Choose a save location. The file is saved as
.hwbackup.json.Import vocabulary (Windows)
1
Open Settings → Backup
Open HyperWhisper and go to Settings → Backup.
2
Choose a file
Click Choose file and pick your
.hwbackup.json. The app inspects the file and shows which sections it contains, along with the vocabulary entry count.3
Select Vocabulary and choose a conflict policy
Tick Vocabulary and pick how to handle words that already exist:
- Skip (default) — leaves the existing entry untouched.
- Replace — updates the replacement text, sort order, and source of the matching entry (the entry’s ID and creation date are preserved).
4
Apply the import
Click Apply. A confirmation dialog shows how many entries will be added versus how many conflicts exist. Confirm to proceed. The app reports the final import summary.
Migrating vocabulary between macOS and Windows
Both platforms read and write the same.hwbackup.json vocabulary format, so moving your vocabulary from one platform to the other requires no conversion:
- Export a vocabulary-only backup on the source platform (see above).
- Import the
.hwbackup.jsonfile on the destination platform.
The
.hwbackup.json format does not carry the case-sensitivity flag. If you need case-sensitive matching on a specific platform, set that flag manually after importing.