Analyze Your Library
The Analyze Library tool runs music theory analysis on every unanalyzed track in your library at once — detecting key, mood, BPM, and chords for each file. Once complete, this data powers mood-based playlist generation in Library AI and richer responses in the AI ask panel.
Running the Analysis
Open Library AI (sparkle icon in the Library header). If you have unanalyzed tracks, a quick-action chip appears:
[SCREENSHOT: "Analyze N tracks" chip in Library AI home]
Analyze N tracks
Tap it to start. You can also type “analyze my library” in the input field.
During Analysis
A progress panel replaces the home state showing:
[SCREENSHOT: Analysis progress panel — bar, count, current track name, cancel button]
- A progress bar filling from left to right
- N / Total track count
- The current track being analyzed (filename)
- A ✕ Cancel button to stop early
Analysis runs sequentially — one track at a time — to avoid overloading the audio engine. The speed depends on track duration and your device’s processing power; expect roughly 1–5 seconds per track.
Canceling
Tap ✕ in the progress panel to stop. Tracks analyzed before you canceled retain their results. You can resume by tapping the analyze chip again — only unanalyzed tracks are processed.
The Result
When analysis completes:
[SCREENSHOT: Analysis result card — track count, description, Done button]
- “N tracks analyzed” with a count of how many were skipped (e.g. tracks that were already analyzed)
- A note explaining that mood, key, and chord data is now available
- A Done button to return to the Library AI home
What Gets Analyzed
Every track that has a local audio file path is eligible. Tracks that:
- Don’t have a local file (Plex streams not yet downloaded)
- Were already analyzed
…are skipped automatically.
Re-evaluating Your Library
If you want to re-run analysis on all tracks (including previously analyzed ones — useful after an app update that improves the analyzer), look for the “reevaluate” button in the Library AI home state, visible when all tracks are already analyzed.
[SCREENSHOT: "All tracks analyzed" state with reevaluate button]
How the Data is Used
After analysis, the data is used by:
| Feature | How it uses the data |
|---|---|
| Library AI mood playlists | Filters your library by mood, BPM range, and key mode |
| AI ask panel | The getTrackMusicTheory tool reads the stored analysis |
| Track Info Panel | Shows key, mood, BPM, and chords for the current track |
| Music Chat (studio) | Provides musical context for the current project’s mix |
The analysis data stays on your device. It is never uploaded or shared.