/shaq

A CLI client for Shazam

Primary LanguagePythonMIT LicenseMIT

shaq

CI PyPI version

A bare-bones CLI client for Shazam.

shaq in action

Installation

shaq is available via pip or pipx:

pip install shaq
pipx install shaq

If you run into installation errors, make sure that you have PortAudio installed. On Debian-based systems:

sudo apt install -y portaudio19-dev

shaq is also available on the Arch User Repository as shaq.

Usage

Detect by listening to the system microphone:

# shaq listens for 10 seconds by default
shaq --listen

# tell shaq to listen for 15 seconds instead
shaq --listen --duration 15

Detect from an audio file on disk:

# shaq truncates the input to 10 seconds
shaq --input obscure.mp3

# ...which can be overriden
shaq --input obscure.mp3 --duration 15

See shaq --help for more options.

The name?

Shazam, Shazaam, Kazaam, Shaquille O'Neal.