Skip to content

epsilver/keybpm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

keybpm

Look up the musical key and BPM of any song from the command line.

$ keybpm radiohead creep
  Radiohead - Creep  |  Key: G major  |  BPM: 92
  Radiohead - Creep - Acoustic  |  Key: G major  |  BPM: 166
  Kelly Clarkson - Creep - Live  |  Key: G major  |  BPM: 94
  ...

Install

Requires Python 3. No dependencies.

curl -o ~/.local/bin/keybpm https://raw.githubusercontent.com/yourusername/keybpm/main/keybpm
chmod +x ~/.local/bin/keybpm

Or clone and symlink:

git clone https://github.com/epsilver/keybpm.git
ln -s "$PWD/keybpm/keybpm" ~/.local/bin/keybpm

Usage

keybpm <query>            # search by artist, song, or both
keybpm -1 <query>         # show only the top result
keybpm --json <query>     # output as JSON
keybpm -1 --json <query>  # top result as JSON (useful for scripting)

Examples

$ keybpm daft punk get lucky -1
  Daft Punk - Get Lucky  |  Key: F# minor  |  BPM: 116

$ keybpm tame impala -1 --json
{
  "artist": "Tame Impala",
  "title": "The Less I Know the Better",
  "key": "C# minor",
  "bpm": 117
}

How it works

Queries the Tunebat search API and displays key/BPM data. No API key needed.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages