shazam-cli

A small command-line tool for recognizing audio files with ShazamIO and writing Shazam metadata back to the file.

The package installs as shazam-cli, but the command-line executable is shazam.

Installation

For normal CLI usage, install with pipx:

pipx install shazam-cli

Or install with pip:

python -m pip install shazam-cli

Usage

Recognize an audio file and print the raw Shazam result:

shazam recognize path/to/audio.mp3

Write recognized metadata tags and rename the file to Artist - Title.ext:

shazam tag path/to/audio.mp3

Tag and rename every FLAC file in the current directory:

shazam tag *.flac

Write tags without renaming the file:

shazam tag --no-rename path/to/audio.mp3

Create a renamed copy instead of renaming the original file:

shazam tag --copy-renamed path/to/audio.mp3

Preview the match, tags, and rename path without writing files:

shazam tag --dry-run path/to/audio.mp3

Skip cover art:

shazam tag --no-cover path/to/audio.mp3

Fetch Shazam metadata by ID:

shazam track 123456789
shazam artist 123456789

Development

Install locally in editable mode:

python -m pip install -e .

Build distribution files:

python -m pip install -U build twine
python -m build
twine check dist/*

Publishing

This project includes a GitHub Actions workflow for PyPI Trusted Publishing. Configure a pending publisher on PyPI for:

• Project name: shazam-cli
• Owner: bostrt
• Repository: shazam-cli
• Workflow filename: publish.yml
• Environment name: pypi

Then create a GitHub release to publish to PyPI.