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