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.

Use Song Recognition in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Song Recognition and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Song Recognition skill

Details

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

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

Song RecognitionStart free

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