Storage & Appearance

The Storage, Appearance, and Library tabs control how Vocoding manages data, looks, and stores your saved prompts.

---

Storage

Storage Usage

Metric	Description
Total items	Number of stored entries
Total size	Disk space used
Saved items	Items protected from automatic cleanup
Saved size	Disk space used by protected items

Retention Modes

Mode	Behavior
Manual (Keep All)	Never auto-delete anything
Session	Delete when session closes
Time-based	Delete after specified time (15 min to 7 days)
Size-based	Delete when total size exceeds limit (50 MB to 5 GB)
Count-based	Keep only N most recent items (10 to 1000)
Immediate Delete	Delete audio immediately after processing

Purge and Refresh Actions

Button	Description
Manual Purge	Delete all items not marked as saved
Refresh	Recalculate storage statistics

---

Appearance

Language

Option	Description
English	English interface
Espanol	Spanish interface

Theme

Option	Description
Light	Light color scheme
Dark	Dark color scheme
System (default)	Match your OS preference

Window Opacity

Adjust window transparency: 50% to 100% (default: 85%)

Lower opacity makes the window semi-transparent, allowing you to see content behind it.

Font Size

Option	Description
Small	Compact text
Medium (default)	Standard size
Large	Larger text

---

Library Tab

This tab provides the same prompt management as the dedicated Prompts view (Cmd + 4).

Feature	Description
Search	Filter prompts by text
Tag filter	Filter by tags
Import	Import prompts from JSON
Export	Export all prompts as JSON

---

Data Locations

Configuration Files

Data	Location
Settings	~/.vocoding/config/settings.json
Custom Agents	~/.vocoding/config/custom_agents.json (encrypted)
Project Profiles	~/.vocoding/config/projects.json
Agent Preferences	~/.vocoding/config/agent_preferences.json

Data Storage

Data	Location
Whisper Models	~/.vocoding/models/
History	~/.vocoding/storage/history/
Audio Archive	~/.vocoding/storage/archive/
Exports	~/.vocoding/storage/exports/

---

API Key Security

API keys are stored securely in your operating system's credential manager:

• macOS: Keychain
• Windows: Credential Manager

API keys are never stored in plain text files.

---

Resetting Settings

Reset to Defaults

1. Scroll to the bottom of Settings
2. Click Reset to Defaults
3. Confirm

What's reset: All settings return to default values, shortcuts restored.

What's preserved: Custom agents, project profiles, history, downloaded models.

Complete Reset

To completely reset Vocoding:

1. Quit Vocoding
2. Delete the ~/.vocoding/ folder
3. Restart Vocoding

Warning: This deletes ALL data including history, custom agents, and downloaded models.