What it does
Music Analyzer listens to a folder of tracks and writes an Excel report with one row per track. Each row has the genre, style, instruments, vocals, moods, tempo, key, energy, a written description, search keywords and suggested placements, which is everything a music supervisor asks about.
The second half of the app, Search Library, reads those reports so you can find a track by describing it (“sad piano, slow build”), listen to it, and build a pitch list.
How it works, in plain English
- Your file tags (genre, BPM, composer) are the starting point.
- The app measures the audio on your computer: tempo, key, loudness, brightness and rhythm.
- A built-in listening model (it runs locally) spots instruments, vocals, style and mood.
- Optional: Claude turns those facts into a clear description, mood words and keywords.
Installing
You only do this once. The installer sets everything up in its own private folder, so it will not interfere with anything else on your computer.
The download
Unzip the download into a folder. It contains these files, which must stay together while you install:
music_analyzer_app.py(the program)requirements.txt(the list of parts to install)Install.commandandUninstall.command(Mac)Install-Windows.batandUninstall-Windows.bat(Windows)
On a Mac
- Install Python 3.12 if you haven’t already: python.org/downloads/. Open the installer and click through to the end.
- Right-click
Install.commandand choose Open, then click Open again. (Right-click is only needed the first time, to get past the macOS safety check.) - Wait. A Terminal window shows progress. The big step can take 5 to 15 minutes, and it is fine if it looks quiet for a while.
- Done. When you see SUCCESS, Lionel’s Music Analyzer is on your Desktop. Double-click it. You can drag it to the Dock or the Applications folder.
On Windows
- Install Python 3.12 if you haven’t already: python.org/downloads/. In the installer, tick Add python.exe to PATH and leave tcl/tk and IDLE ticked. (The Microsoft Store version of Python won’t work.)
- Double-click
Install-Windows.bat. If Windows says “Windows protected your PC”, click More info, then Run anyway. - Wait. A black window shows progress. The big step can take 5 to 15 minutes.
- Done. When you see SUCCESS, the app opens by itself, and a Lionel’s Music Analyzer shortcut is on your Desktop and in the Start menu.
Updating
When you get a new music_analyzer_app.py, put it in the install folder (replacing the old one) and run the installer again. It is fast the second time, and your settings, reports, shortlist and saved results are kept.
Uninstalling
Run Uninstall.command (Mac) or Uninstall-Windows.bat (Windows). It removes the app and its private folder. It asks before deleting your saved settings and, on a Mac, your saved API key. Your Excel reports are never touched.
Backup plan: install with Terminal
If the installer won’t open or stops with an error, the same steps can be done by hand. Nothing here is risky: it only creates the private folder .music_analyzer in your home folder.
Mac: open Terminal (press ⌘ Space, type Terminal, press Return). Type cd (with a space after it), drag the unzipped folder into the Terminal window, and press Return. Then try the installer from there:
chmod +x Install.command ./Install.command
If that still doesn’t work, run the steps one at a time. Paste each block and wait for it to finish before the next:
python3.12 -m venv ~/.music_analyzer/venv ~/.music_analyzer/venv/bin/python -m pip install --upgrade pip wheel "setuptools<81" ~/.music_analyzer/venv/bin/python -m pip install numpy==1.26.4 scipy==1.11.4 soundfile==0.12.1 librosa==0.10.1 ~/.music_analyzer/venv/bin/python -m pip install -r requirements.txt ~/.music_analyzer/venv/bin/python music_analyzer_app.py --install-app
Windows: open the folder in File Explorer, click the address bar, type cmd and press Enter. A black window opens in the right place. Try the installer from there:
Install-Windows.bat
If that still doesn’t work, run the steps one at a time:
py -3.12 -m venv %USERPROFILE%\.music_analyzer\venv %USERPROFILE%\.music_analyzer\venv\Scripts\python -m pip install --upgrade pip wheel "setuptools<81" %USERPROFILE%\.music_analyzer\venv\Scripts\python -m pip install numpy==1.26.4 scipy==1.11.4 soundfile==0.12.1 librosa==0.10.1 %USERPROFILE%\.music_analyzer\venv\Scripts\python -m pip install -r requirements.txt %USERPROFILE%\.music_analyzer\venv\Scripts\python music_analyzer_app.py
Check that everything is installed
In Terminal (Mac) or the black window (Windows), run the checker using the private environment’s Python:
# Mac ~/.music_analyzer/venv/bin/python music_analyzer_app.py --doctor # Windows %USERPROFILE%\.music_analyzer\venv\Scripts\python music_analyzer_app.py --doctor
It prints a short checklist and says exactly what is missing and how to fix it.
Quick start
- Choose Music Folders. Pick one or more folders of audio (MP3, WAV, FLAC, M4A, AAC, OGG, AIFF and more).
- Choose a report location. This is where the Excel file will be saved.
- Tick the options you want (see the next section). If your music has singing, tick My tracks have vocals.
- Press Analyze Music. A progress bar and a running log show what is happening. You can press Stop at any time and nothing is lost.
- Open the report, or press ⌘ F to open Search Library and start finding tracks.
The Analyzer window
| Option | What it does |
|---|---|
| Use Claude metadata enrichment | Adds the written description, mood words and keywords. See Claude and cost. Without it you still get a full report. |
| Listen to audio (AI) | Runs the built-in listening model to find instruments, vocals, style and mood. Turn it off for a much faster, tag-only pass. |
| My tracks have vocals | Tells the app to analyze the singing (male, female, choir, rap). Leave it off for instrumental libraries and every track is simply marked Instrumental. |
| Transcribe lyrics | Writes the sung words into the report using a local speech model. Needs “My tracks have vocals”. See Vocals and lyrics. |
| Add to existing report | New and changed tracks are added to the report you already have, instead of replacing it. Handy for adding a new album. |
| Re-use earlier results | Tracks you have already analyzed are not redone, which saves time and money. Turn it off to force a fresh analysis. |
| Save a CSV copy | Also writes a plain .csv next to the Excel file. |
| Preview only | Lists what would be analyzed. Nothing is analyzed or saved. |
| Open report when finished | Opens the finished report automatically. |
| Include subfolders | Also looks inside folders within your chosen folders. |
| Audio sample | How much of each track is listened to: 30 seconds, 60 seconds, 90 seconds or the whole track. Longer is a little more thorough and a little slower. |
| Album context (optional) | A short note that helps the app, for example 1980s pop or Album Name=style; Another Album=style. You can also mention things you know, such as “female vocals” or “prominent piano”. |
Most of these are also in the Options menu at the top of the screen.
Claude and cost
Claude is optional. Without it you still get genre, instruments, tempo, key, energy and basic moods. With it you also get a polished three-sentence description, richer mood words, search keywords and a short “Vibe Check” line.
Your API key
- Create a key at the Anthropic Console (Help ▸ Get an Anthropic API Key takes you there).
- Add a few dollars of credit (Help ▸ Add API Credits / Billing).
- Paste the key into the Anthropic API key box. It is stored in your Mac’s Keychain, never in a text file.
You pay Anthropic directly, and usage is typically a small fraction of a cent per track.
Choose a mode
| Mode | Best for |
|---|---|
| Smart – Haiku, Sonnet only for tricky tracks | The default. Fast and inexpensive. A stronger model is used only for tracks with no usable genre information. |
| Economy – Haiku 5.5 | The lowest cost for big libraries. |
| Best – Sonnet 5.5 | The most polished writing, at a higher price. |
Vibe Check tone
The short, witty line in the Vibe Check column can be light wit with an occasional dark streak, dry and playful, or straight, with no jokes. Find it under Options ▸ Vibe Check tone.
Vocals and lyrics
Vocal type
With My tracks have vocals on, each track gets one of: Male vocals, Female vocals, Choir / group vocals, Rap vocals, Vocals (synthetic-sounding) or simply Vocals when the voice type is unclear.
female vocals. The app will use it whenever the audio is a close call.Lyrics
Turn on Transcribe lyrics to add the sung words to the Lyrics (auto) column. Choose how much of each song to read (About 2 minutes or Whole song) and which speech model to use:
- Whisper medium: more accurate, larger one-time download (about 1.5 GB).
- Whisper small: lighter and faster (about 500 MB), a bit less accurate.
Optionally, Analyze lyric themes with Claude adds a few theme words (love, loss, freedom…). Claude only sees a short excerpt, and never quotes it back.
Your report
The Excel file has four sheets:
- Music Library: one row per track.
- About this report: what every column means and where it came from.
- Summary: totals for the whole library.
- Review Queue: tracks the app is least sure about, lowest confidence first, with the reasons.
The main columns
| Column | What it tells you |
|---|---|
| Genre, Style / Sub-genre, Era | The musical category, a more specific style, and the decade the sound evokes. |
| Instruments | What the app heard, strongest first. |
| Vocals | Instrumental, or the voice type. |
| Moods | Searchable feeling words, matched to the track’s energy. |
| Tempo (BPM), Tempo Feel, Rhythmic Feel | Measured speed, how fast it feels, and the groove (for example straight or swung). |
| Energy, Key | Low to very high, and the musical key. |
| Description | A short supervisor-style pitch for the track, ending with where it could be placed. |
| Keywords | 10 to 12 search terms. |
| Lyrics (auto), Lyric Themes | Only when you turned lyrics on. |
| Analysis Confidence, Review Flags | A 0 to 100 “how much should I double-check this” score and the reasons. It is a guide, not a guarantee. |
| Classifier Detail (raw) | The raw scores behind the answers, for the curious. |
Search Library
Open it with File ▸ Search My Library or ⌘ F. It searches every Music Analyzer report in a folder at once.
- Point it at your reports. Choose the folder that holds your Excel reports and press Load / Refresh. Tick Include subfolders if they are spread around. The app remembers the folder and loads it automatically next time.
- Type what you are looking for in the big search box. Results update as you type.
- Narrow it down with the filters: BPM range, length, key, genre, vocals and which spreadsheet.
- Select a track to read its full description. Double-click it to hear it.
Smart synonyms
With Smart synonyms on, searching “sad” also finds “melancholic”, “somber” and similar words. Turn it off for exact matching.
The buttons under the results
- Open in default app: plays the file in Music, QuickTime or whatever your Mac uses.
- Show in Finder: reveals the file.
- Copy path: copies the file location to paste elsewhere.
- + Shortlist: adds the track to your pitch list.
- More like this: finds similar tracks by mood, instruments, keywords, genre and tempo.
- Moved your music?: reconnects your tracks if you moved the files.
Search tips
| Type this | To find |
|---|---|
sad piano | Tracks matching both words anywhere in their details. |
"slow build" | The exact phrase. |
-vocals | Exclude a word. Great for instrumental-only searches. |
mood:tense | Search one field only. |
inst:cello | Tracks with a cello. |
bpm:90-110 | A tempo range. |
era:1980s | A decade. |
rhythm:swung | A groove. |
energy:low | An energy level. |
Combine them freely: mood:hopeful inst:piano bpm:70-100 -vocals.
Press Esc to clear the search box. The Clear button resets the search and all filters.
Preview player and waveform
You can listen without leaving the app. The player sits across the bottom of the Search window and works on both the Results and Shortlist tabs.
- Play a track: select it and press Play, press Space, or double-click the row.
- Waveform: once a track loads you see its shape. The part already played is shaded and a red line marks where you are.
- Jump anywhere: click the waveform. Click and drag to scrub back and forth.
- Skip and volume: use the keyboard shortcuts below, or the volume slider.
If you select a different track while one is playing, the music keeps going. Press Play (or double-click) to switch to the one you selected.
Customizing the columns
- Sort: click a heading. Click again to reverse.
- Resize: drag the edge between two headings. If the columns are wider than the window, a scroll bar appears at the bottom of the table.
- Reorder: drag a heading sideways. A blue bar shows where it will land.
- Show or hide: click Columns ▾ (or right-click any heading) and tick the ones you want. Energy, Rhythm / Groove and Spreadsheet are hidden until you turn them on.
- Start over: Reset column layout in the same menu, or View ▸ Reset Column Layout.
Your layout is saved and shared between Results and Shortlist, and it is still there next time you open the app.
Window size and position are remembered too, for both the Analyzer and Search windows, along with the divider between the results list and the track details.
The standard order is: Track, Artist, Genre, Style, BPM, Length, Key, Instruments, Tempo Feel, Moods, Era, Vocals.
Shortlist: your pitch list
Click + Shortlist on any track to collect it on the Shortlist tab. The list is saved between sessions.
- Move up / Move down to set the running order.
- Remove or Clear all to tidy up.
- Export to Excel makes a clean pitch sheet with descriptions, keywords and file paths.
- Copy as text list puts a numbered list on your clipboard, ready to paste into an email.
- Copy audio files to a folder gathers the actual audio files, numbered in your order, ready to send or upload. Anything it could not find is listed afterwards.
Moved your music?
Reports remember where each file lived. If you move your music to a new drive or folder, you do not need to redo anything, and you do not need to fix tracks one by one. Reconnect the whole library at once:
- Press Moved your music? (or Track ▸ Moved Your Music?).
- Confirm the old folder. The app guesses it from your tracks, for example
/Volumes/OldDrive/Music. - Choose the folder where that music lives now.
Every track under the old folder, including subfolders, is now found under the new one, and the app tells you how many were found.
This only changes where the app looks. Your Excel reports are not rewritten.
Keyboard shortcuts
On a Mac, use ⌘ (Command). On Windows or Linux, use Ctrl.
Analyzer window
| ⌘ O | Choose music folders |
| ⌘ S | Choose report location |
| ⌘ Return | Analyze Music |
| ⌘ . | Stop |
| ⌘ F or ⌘ 2 | Open Search Library |
Search window
| Space | Play or pause the selected track |
| ⌘ ← / ⌘ → | Back or forward 10 seconds |
| ⌘ ↑ / ⌘ ↓ | Volume up or down |
| ⌘ . | Stop and rewind |
| ⌘ F | Jump to the search box |
| ⌘ R | Reload reports |
| ⌘ O | Choose reports folder |
| ⌘ D | Add to shortlist |
| ⌘ L | More like this |
| ⌘ Return | Open in default app |
| ⌘ 1 / ⌘ 2 | Switch between the Analyzer and Search windows |
| ⌘ W | Close the window |
Troubleshooting
The installer won’t open or stops with an error
- Mac says it “can’t be opened” or is from an unidentified developer: right-click
Install.command, choose Open, then Open again. Or go to System Settings ▸ Privacy & Security, scroll down, and click Open Anyway. - Mac says “permission denied”: unzipping can remove the permission to run the file. Use Terminal (see the backup plan) and type
chmod +x Install.command, then./Install.command. - Windows says “Windows protected your PC”: click More info, then Run anyway.
- “No suitable Python found”: install Python 3.12 from python.org (see Installing). Newer versions such as 3.13 and 3.14 are not supported yet, and the Microsoft Store version of Python won’t work.
- A download failed or it stops part-way: check your internet connection and that you have about 3 GB free, then simply run the installer again. It picks up where it left off.
- The Windows window closes immediately: open the folder, type
cmdin the address bar, press Enter, and runInstall-Windows.batfrom there so you can read the message. - Still stuck: follow the Terminal steps in the backup plan, which shows each step and any error message.
Command+Tab says “Python” instead of the app name (Mac)
Quit the app, run Install.command again, and open the new app from your Desktop. The installer builds the app as its own named program and checks that it works. If it didn’t apply, run the checker from the backup plan and look for the “app-name fix” line. Windows groups the window under the shortcut’s name, so this only affects Macs.
Buttons seem to ignore clicks (Mac)
This is a known problem with older versions of the window toolkit. Choose Help ▸ Button not responding? to check your version. If it is older than 8.6.13, install Python 3.12 from python.org and run Install.command again. Until then, the menu bar and the keyboard shortcuts always work.
The preview won’t play
- If it says the file isn’t where the spreadsheet says, use Moved your music?.
- The installer already adds audio playback. If the app says it can’t, run this in Terminal (Mac)
~/.music_analyzer/venv/bin/python -m pip install sounddeviceor the black window (Windows)%USERPROFILE%\.music_analyzer\venv\Scripts\python -m pip install sounddevice, then try again. - Check your Mac’s output device and volume, and the app’s own volume slider.
An instrument looks wrong
The listening model sometimes mixes up similar sounds, especially in dense mixes. Three things help:
- Add a hint to Album context, such as
prominent pianoorheavy synths. - Increase the Audio sample to 90 seconds or the whole track.
- Check the Review Queue sheet for tracks flagged as uncertain, and fix those by hand in Excel.
The lyrics start with a stray line
Speech models sometimes “hear” a phrase over a quiet or instrumental intro. The app removes the common ones automatically. If a stray line gets through, just delete it in the spreadsheet.
Nothing was found when I searched
Check that the Reports folder points at the folder holding your .xlsx reports, tick Include subfolders if needed, and press Load / Refresh. Reports must have been made by Music Analyzer. Make sure a report isn’t open in Excel when you load it.
Where is the log?
Choose Tools ▸ Open Analysis Log. If something fails to start, details are in ~/Library/Logs/MusicAnalyzer.log (Mac). On Windows, run the app from the black window with %USERPROFILE%\.music_analyzer\venv\Scripts\python %USERPROFILE%\.music_analyzer\app\music_analyzer_app.py to see messages.
Questions people ask
Is my music uploaded anywhere?
No. The audio is analyzed on your computer. If you use Claude, only text facts about each track are sent, never the audio.
Do I have to use Claude?
No. Without it you still get a full report. Claude just writes nicer descriptions and keywords.
How long does it take?
It depends on your Mac and how many tracks you have. Re-running on tracks you have already analyzed is nearly instant because results are remembered. Turning on lyrics is the slowest option.
Can I add new music to an old report?
Yes. Keep Add to existing report ticked and point to the same report file. Only new or changed tracks are analyzed.
Can I change what the app says about a track?
Yes. Edit the spreadsheet. Search Library reads whatever is in it, so your corrections show up after you press Load / Refresh.
Does it work on Windows?
Yes. There is a Windows installer that adds a Desktop and Start menu shortcut. The Command+Tab name fix is Mac-only; Windows names the window after the shortcut.