Song Recognition

SkillFiles & storage

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.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Song Recognition skill

What this skill tells your AI

The instructions your AI receives, as published by remorses/opencode-config in skills/song-recognition/SKILL.md and read by ahel’s review.

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:

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.

Signals

GitHub stars: 43
Forks: 2
Last commit: Sep 2026

ahel review

K6low
bundled executables the agent is told to run

Automated review, not a security audit. Ruleset v1+k2.

Advanced

Item type: skill
Key: song-recognition
Source: github.com/remorses/opencode-config

github.com/remorses/opencode-config