evanpurkhiser / keyfinder-cli Goto Github PK

This small utility is the automation-oriented DJs best friend. By making use of Ibrahim Sha'ath's high quality libKeyFinder library, this utility can be used to estimate the musical key of many different audio file formats.

Installing this software exposes the keyfinder-cli command on your system.

The most basic usage of this utility is to provide a path to an audio file, it will quickly compute the estimated global music key of the audio file and print it to stdout.

$ keyfinder-cli AMajor.mp3
A

In the case that there is no key (silence) nothing will be printed to stdout and the program will exit with a 0 status code.

Three different key notations are supported and can be toggled:

1. -n standard for Standard Key Notation

   Keys are outputed using the standard notation. For example, Eb is equivelant to E flat. A is equivelant to A Major. Sharps are not used. This is the default notation mode used to output keys when no other otpions are specified

2. -n openkey for Open Key Notation

   Keys are outputed using BeaTunes Open Key notation. Keys like 1m are equivelant to C Major. This is what Traktor uses for it's key notation.

3. -n camelot for Camelot Key Notation

   Keys are outputed using the Camelot Easymix Wheel notation. Similar to Open Key notation 8B is equivelant to C Major.

You will need to have the following dependencies installed on your machine

• ffmpeg (This was not tested with libav)
• libkeyfinder

As long as these two dependencies are installed then you should be able to simply type:

$ make
$ make install

# Or suffix with PREFIX= to specify the install prefix
$ PREFIX=$HOME/.local make install