This project attempts to embed a story into a music playlist by sorting the playlist so that the order of the music follows a narrative arc. Currently, music is fitted to a fixed narrative arc template based on an estimate of the tempo of the songs in beats per minute.

This project is implemented in Python and uses TensorFlow models from the Essentia library to extract the tempo of the songs.

To use this project, first follow the Essentia installation instructions to install it with TensorFlow support. Then install the remaining required packages using pip:

pip install -r requirements.txt

Afterwards, you can use the makefile to compile and then install an executable Python zip archive:

make all
sudo make install

To run the program, execute it while passing the audio files as command-line arguments:

psb files [files ...] >> playlist.txt

The algorithm to fit the calculated narrative arc values to a narrative arc template was originally proposed by Dr. Zachary Friggstad.