# Song Recognition

> Identify songs from audio files using ShazamIO. Use when the user asks to recognize a song, identify music from an audio file, find what song is playing, or Shazam an audio clip.

- Skill: `remorses/song-recognition` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add remorses/song-recognition`
- Raw SKILL.md: https://api.skillmd.com/api/skills/remorses/song-recognition/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: remorses (https://skillmd.com/u/remorses)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/remorses/song-recognition

---


# Song Recognition

Identify songs from audio files using ShazamIO (reverse-engineered Shazam API).
Free, unlimited, no API key needed. Uses the full Shazam catalog.

## Usage

Run the bundled script with `uv run`:

```bash
uv run --with shazamio ~/.config/opencode/skills/song-recognition/recognize.py /path/to/audio.mp3
```

The script tries multiple offsets through the file (every 5 seconds) because
Shazam often fails on intros, quiet sections, or ambient parts. It stops at
the first match.

## Notes

- Shazam returns **one result per request**, not a ranked list.
- Short clips (under 5s) may not match. The script uses 15s clips.
- If no offset matches, the song may not be in Shazam's catalog,
  or it could be a cover/remix that fingerprints differently.
- Results include title, artist, genre, and a Shazam URL.