Skip to content

Transcriptions ​

View, search, and manage your transcription history in Vox.

Accessing Transcriptions ​

Click the tray icon and select View Transcriptions:

Tray Menu

Transcription History ​

Overview ​

Vox automatically saves all your transcriptions, allowing you to:

  • Review past recordings
  • Copy text to clipboard
  • Play back original audio
  • Add missed words to your dictionary
  • Delete unwanted transcriptions

Transcription List ​

The transcriptions view displays:

  • Timestamp: When the recording was made
  • Text: The transcribed content
  • Duration: Length of the original recording
  • Actions: Quick action buttons

Transcriptions are sorted by date, with the most recent at the top.

Working with Transcriptions ​

Copying Text ​

To copy a transcription to your clipboard:

  1. Find the transcription you want
  2. Click the copy icon or text
  3. Text is copied to clipboard
  4. Paste anywhere with ⌘ + V

Playing Audio ​

To replay the original audio:

  1. Click the play button next to the transcription
  2. Audio plays through your default output device
  3. Useful for verifying accuracy or reviewing context

Audio Retention

Audio is only available if retained. Configure retention in Settings → Speech → Audio retention.

Adding to Dictionary ​

If a transcription contains a word that was incorrectly transcribed:

  1. Click Add to Dictionary
  2. Enter the correct spelling
  3. Vox will recognize this word in future transcriptions

See Dictionary for more details.

Deleting Transcriptions ​

To remove a transcription:

  1. Click the delete icon
  2. Confirm deletion
  3. Both text and audio are removed permanently

Permanent Deletion

Deleted transcriptions cannot be recovered. Make sure you've copied any important text before deleting.

Searching Transcriptions ​

Search Functionality ​

Use the search box to find specific transcriptions:

  • Search by text content
  • Search by date
  • Results update in real-time as you type

Search Tips ​

  • Exact phrases: Use quotes for exact matches (e.g., "important meeting")
  • Multiple words: Search returns transcriptions containing any of the words
  • Date ranges: Filter by date using the date picker

Transcription Details ​

Viewing Details ​

Click on any transcription to view:

  • Full text: Complete transcription content
  • Metadata: Date, time, duration
  • Audio: Play original recording
  • Model used: Which speech model was active
  • Enhancement: Whether AI Enhancement was applied

Enhanced vs. Non-Enhanced ​

Transcriptions show whether AI Enhancement was used:

  • Enhanced: Processed by LLM, improved grammar and formatting
  • Non-enhanced: Raw output from Whisper model

Managing Storage ​

Storage Location ​

Transcriptions are stored locally in:

~/Library/Application Support/Vox/transcriptions/

Audio Storage ​

Original audio recordings are stored separately:

~/Library/Application Support/Vox/audio/

Audio retention is configurable in Settings → Speech → Audio retention.

Disk Space ​

To free up disk space:

Delete old transcriptions:

  1. Select transcriptions you no longer need
  2. Click delete
  3. Both text and audio are removed

Reduce audio retention:

  1. Navigate to Settings → Speech
  2. Lower Audio retention number
  3. Older audio files are automatically cleaned up

Storage Management

If disk space is limited, reduce audio retention to 5 or fewer recordings. Text transcriptions take minimal space.

Exporting Transcriptions ​

Export Options ​

While Vox doesn't have a built-in export feature, you can:

Export to text file:

  1. Copy transcriptions one by one
  2. Paste into a text editor
  3. Save as .txt or .md

Export to database:

  • Transcriptions are stored in a SQLite database
  • Advanced users can query directly: ~/Library/Application Support/Vox/transcriptions.db

Backup:

  • Manually back up the transcriptions folder
  • Include in Time Machine or cloud backup

Privacy and Data ​

Local Storage ​

All transcriptions are stored locally:

  • Never synced to cloud (unless you backup manually)
  • Never sent to Vox servers
  • Only sent to AI providers if AI Enhancement is enabled

Sensitive Information ​

If you transcribe sensitive information:

  • Delete transcriptions after use
  • Disable audio retention
  • Don't enable AI Enhancement for sensitive content
  • Encrypt your backup if you export data

Data Privacy

If you enable AI Enhancement, transcription text (not audio) is sent to external AI providers. Review their privacy policies before enabling.

Transcription Preferences ​

Configure how transcriptions are formatted:

Transcription Preferences

Navigate to Settings → General → Transcription Preferences:

Finish with Period ​

Automatically adds a period at the end of transcriptions.

Enable if you:

  • Transcribe complete sentences
  • Want consistent punctuation
  • Use transcriptions for formal writing

Disable if you:

  • Transcribe fragments or keywords
  • Add your own punctuation manually
  • Use transcriptions for code or technical content

Start with Lowercase ​

Begins transcriptions with a lowercase letter.

Enable if you:

  • Continue existing sentences
  • Add inline comments in code
  • Want lowercase by default

Disable if you:

  • Start new sentences
  • Want automatic capitalization
  • Transcribe formal content

Hold Shift to Capitalize ​

Press Shift while recording to capitalize the first letter.

How it works:

  1. Hold Shift when pressing your recording shortcut
  2. Recording starts as normal
  3. First letter is automatically capitalized
  4. Overrides "Start with lowercase" setting

Useful for:

  • Starting new sentences
  • Proper nouns
  • Beginning of paragraphs
  • Overriding lowercase setting temporarily

Best Practices ​

Organizing Transcriptions ​

While Vox doesn't support folders or tags, you can:

  • Use consistent naming in your speech (e.g., "Project X: ...")
  • Search for specific keywords to filter
  • Export and organize externally
  • Delete transcriptions you no longer need regularly

Reviewing Accuracy ​

Periodically review transcriptions to:

Backup Strategy ​

Recommended backup approach:

  1. Enable Time Machine for automatic backups
  2. Periodically export important transcriptions
  3. Keep audio retention low (5-10) to save space
  4. Back up the entire Vox application folder monthly

Troubleshooting ​

Transcription Not Appearing ​

Solutions:

  1. Refresh the transcriptions view
  2. Check that recording completed successfully
  3. Verify transcription wasn't immediately deleted
  4. Restart Vox

Audio Not Available ​

Solutions:

  1. Check audio retention setting
  2. Older recordings may have been cleaned up
  3. Verify disk space wasn't full during recording
  4. Increase retention to keep more audio

Can't Delete Transcriptions ​

Solutions:

  1. Check file permissions in ~/Library/Application Support/Vox/
  2. Quit and restart Vox
  3. Manually delete from Finder if necessary
  4. Verify you have write permissions

Search Not Working ​

Solutions:

  1. Check spelling of search terms
  2. Try broader search terms
  3. Clear search and try again
  4. Restart Vox if issue persists

Transcriptions Taking Too Much Space ​

Solutions:

  1. Delete old transcriptions you don't need
  2. Reduce audio retention to 5 or fewer
  3. Set audio retention to 0 to disable audio storage entirely
  4. Export and archive transcriptions externally, then delete from Vox

Advanced Features ​

Database Access ​

Advanced users can directly access the transcriptions database:

Location:

~/Library/Application Support/Vox/transcriptions.db

Tools:

  • SQLite browser
  • SQL queries for custom export
  • Integration with other tools

Advanced Users Only

Direct database access is for advanced users. Incorrect modifications can corrupt your transcription history.

Bulk Operations ​

While Vox doesn't support bulk operations natively, you can:

  • Select multiple transcriptions with Shift+Click (if supported)
  • Use database queries for bulk export
  • Write scripts to process transcriptions

Integration with Other Apps ​

Export transcriptions to integrate with:

  • Note-taking apps: Copy to Obsidian, Notion, Evernote
  • Task managers: Add transcriptions to Todoist, Things
  • Documentation: Include in wikis or knowledge bases
  • Development: Add as code comments or documentation

Next Steps ​

Built with 💜 by the open-source community & core contributors