https://github.com/woodruffw/shaq
A CLI client for Shazam
https://github.com/woodruffw/shaq
Last synced: 6 months ago
JSON representation
A CLI client for Shazam
- Host: GitHub
- URL: https://github.com/woodruffw/shaq
- Owner: woodruffw
- License: mit
- Created: 2023-07-14T00:01:42.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-10T19:04:49.000Z (8 months ago)
- Last Synced: 2025-03-28T20:36:52.271Z (7 months ago)
- Language: Python
- Size: 64.5 KB
- Stars: 107
- Watchers: 3
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# shaq
[](https://github.com/woodruffw/shaq/actions/workflows/ci.yml)
[](https://badge.fury.io/py/shaq)
A bare-bones CLI client for [Shazam](https://www.shazam.com/home).
## Installation
`shaq` is available via `pip` or `pipx`:
```bash
pip install shaq
pipx install shaq
```
If you run into installation errors, make sure that you have PortAudio
installed. On Debian-based systems:
```bash
sudo apt install -y portaudio19-dev
```
`shaq` is also available on the Arch User Repository as [`shaq`](https://aur.archlinux.org/packages/shaq).
## Usage
Detect by listening to the system microphone:
```bash
# 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:
```bash
# 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](https://www.shazam.com/home),
[Shazaam](https://en.wikipedia.org/wiki/Kazaam#%22Shazaam%22),
[Kazaam](https://en.wikipedia.org/wiki/Kazaam),
[Shaquille O'Neal](https://en.wikipedia.org/wiki/Shaquille_O%27Neal).