infinity-player

commit

6d076817c7f103929086b253323d92a06e49a3f0

parent

cda5d53b65094798f9f98cbc89610c684ac9b4c7

Author

Tobias Bengfort <tobias.bengfort@posteo.de>

Date

2017-10-20 18:51

add readme

Diffstat

1 files changed, 50 insertions, 0 deletions

diff --git a/README.md b/README.md

@@ -0,0 +1,50 @@
   -1     1 # infinity player
   -1     2 
   -1     3 An infinite jukebox clone using librosa.
   -1     4 
   -1     5 This program attempts to recreate the wonderful *Infinite Jukebox* on the
   -1     6 command line in python.  It plays the song beat by beat and may jump to similar
   -1     7 beats at any time. This way, the song can play infinitly.
   -1     8 
   -1     9 The process is devided into two steps: Analysing the audio and playing it.
   -1    10 Analysing takes some time, so the result is saved next to the audiofile.
   -1    11 
   -1    12 ## Quickstart
   -1    13 
   -1    14     pip install librosa pyalsaaudio pillow
   -1    15     python player.py <filename>
   -1    16 
   -1    17 ## Open Tasks
   -1    18 
   -1    19 Any help would be appreciated
   -1    20 
   -1    21 -   **Improve audio analysis.** I don't really know what *MFCC* or a
   -1    22     *Constant-Q chromagram* is. The current implementation works ok-ish, but
   -1    23     there can probably be big improvements.
   -1    24 
   -1    25 -   **Improve beat selection.** Currently the selection of the next beat
   -1    26     depends only on the current beat and a set of precomputed probabilities.
   -1    27     Jumps that go back or wide are slightly privileged. I guess a lot more is
   -1    28     possible, e.g. to prevent the song from looping through the same part again
   -1    29     and again.
   -1    30 
   -1    31 -   **Better audio output.** alsaaudio was the first library I got to work, but
   -1    32     it has many flaws. It blocks a lot and it is impossible to know which beat
   -1    33     is currently playing.
   -1    34 
   -1    35 -   **Visual Feedback.** The original infinite jukebox has a great UI. This one
   -1    36     has currently none.
   -1    37 
   -1    38 -   **No Stereo.** This one is probably not that hard to fix. I just skipped it
   -1    39     because there were more interesting problems to think about.
   -1    40 
   -1    41 ## Prior Art
   -1    42 
   -1    43 -   Of course, the now defunct original [Infinite
   -1    44     Jukebox](http://labs.echonest.com/Uploader/)
   -1    45 -   A functional fork called [Eternal Jukebox](https://eternal.abimon.org/)
   -1    46     ([code](https://github.com/UnderMybrella/EternalJukebox)). It uses the
   -1    47     [audio-analysis](https://developer.spotify.com/web-api/get-audio-analysis/)
   -1    48     endpoint at spotify
   -1    49 -   [Remixatron](https://github.com/drensin/Remixatron), a similar project to
   -1    50     this one.