Music Genie

Search YouTube for (copyright free!) music, identify songs from microphone recordings, and download them as tagged MP3s

The main features are:

• easily search for (music) videos on YouTube and choose from top 10 results
• extracted music is tagged
• files are placed in your XDG_MUSIC_DIR or ~/music
• offline support for recording audio and running the recognition pipeline later

You can try it from anywhere with uv installed:

# Search for a song you know
uvx music-genie search "a song"
# Listen to a song that's playing nearby
uvx music-genie listen

If you really like it, you can install it as a uv tool:

uv tool install music-genie

An upshot of this is that you can now invoke music-genie by just running mg.

I built this project to scratch an itch and to try out the release of Claude Opus 4.6. It glues together a couple of remarkable open source projects into a single, simple to use tool.

• yt-dlp
• shazamio
• musicbrainzngs

🤖 AI disclaimer

This tool was built with Claude Code, following my AI policy.

### Tools
- Claude Code (Anthropic) — primary development assistant

### Usage
- **Architecture & design**: Human-driven
- **Implementation**: AI-collaborative (human-directed, AI-written, human-reviewed)
- **Tests**: N/A
- **Documentation**: AI-generated with human review

### Process
AI agents propose changes as PRs, which are reviewed and merged by me. I try to make interactions transparent in the relevant issues or proposed patches. AI-authored commits are tagged with `Co-Authored-By` in the git history.

Releases: PyPi
Source code: Radicle (Github mirror)