## 💡 How Your Data is Stored

🔒

### 100% Client-Side

All your data stays on YOUR computer. Nothing is uploaded to any server. Your library, preferences, and download history live in your browser's local storage.

⚡

### Fast & Efficient

We use IndexedDB for large datasets (clips, downloads) and chrome.storage for preferences. This keeps the extension snappy even with 30k+ songs.

📁

### Recoverable

Downloaded songs include metadata JSON files. If your browser data is lost, you can recover from your local files. We also recommend regular backups.

🎯

### You Own It

Export your data anytime in standard JSON format. No lock-in, no proprietary formats. Your music library belongs to you.

## 📊 Storage Overview

-
Indexed Clips
-
Downloaded
-
Manual Links
-
Custom Names
Last Indexed: -
Last Backup: Never ⚠️ Unsaved Changes

## 💾 Backup Your Data

Regular backups protect against browser data loss. We recommend backing up weekly or after major curation sessions.

📦

### Full Backup

Everything: clips, downloads, preferences, custom names, manual links, curation settings.

✨

### Curation Only

Just your curation work: custom names, manual links, definitive versions, public settings.

📄

### Clips Only

Just the clip metadata as JSON. Lightweight, for sharing or external tools.

## 📥 Restore Data

Import from a previous backup. You can merge with existing data or replace everything.

Merge with existing data When off, imported data replaces everything
📦

### From Full Backup

Restore everything from a full backup file.

✨

### Curation Only

Apply curation settings to your existing library.

📄

### Clips JSON

Import clip metadata from JSON file.

## 🔧 Recovery Tools

Lost your browser data? If you have downloaded songs, you can rebuild your index from the local files.

🔧

### Recover from Files

Scan your Songs folder to rebuild the index from downloaded metadata files.

🔄

### Re-Index from Suno

Fetch fresh data from Suno's servers. Requires being logged in to suno.com.

💡 Tip: Downloaded songs include `.json` metadata files. These contain everything needed to rebuild your index. The recovery tool scans these files and marks them as downloaded.

## ⚠️ Danger Zone

These actions cannot be undone. Make sure you have a backup first!

Clear Download History

Reset download tracking. Your files remain on disk, but the extension forgets what's downloaded.

Clear Curation Data

Remove all custom names, manual links, definitive versions, and public settings.

Clear Everything

Nuclear option. Removes all data and resets the extension to a fresh state.