Jukebox Ultra NRV mkV

Prerequisites

This application assumes it runs on Linux using Alsa.

python3, python-flask, python-requests, mpv, youtube-dl, alsa-utils, python3-pip and libmpv-dev have to be installed. Also from pip, get pyalsaaudio, youtube_dl, passlib, flask-WTF and flask-table.

Installation

• Clone the repo
• Copy config.py.example to config.py and edit it 😎 (gitignore will make sure it is not gitted, cause you have a youtube api key in this)
• To add a favicon, place it in the jukebox/static folder
• Install requirements using pip install -r requirements.txt

$ git clone https://github.com/matthias4217/jukebox-ultra-nrv.git
$ cd jukebox-ultra-nrv
$ pip install -r requirements.txt
$ cp config.py.example config.py
$ <edit config.py>
$ <optionally add a favicon.ico>
$ python3 run.py

Usage

$ python3 run.py

or with a systemd service jukebox (currently very buggy)

$ systemctl start jukebox.service

Should you have screen, you can also use

$ ./start.sh

And if you have tmux, you can do

$ ./tmux.sh

Security

The current use of this application is only among a "friendly" and local network. As such, we haven't yet focused much on security. The passwords are stored using pbkdf2_sha256 from library passlib.

Troubleshooting

If you are using a systemctl service. Check if the service is properly running : $ sudo systemctl status jukebox

Check the logs : $ sudo journalctl -u jukebox.service

Check if youtube-dl is working and up to date youtube-dl https://www.youtube.com/watch?v=6xKWiCMKKJg

If not, update it : sudo youtube-dl -U

Outdated tracks

Tracks may be marked as obsolete. These won't be displayed in the suggestions column. Tracks become outdated if the source is youtube, and youtube-dl returns an "Error: Track not found.". This means that the track doesn't exist on Youtube (it may have been removed, or is unavailable for any reason). An obsolete track may become non-obsolete again if you refresh its metadata and Youtube doesn't return the previous error. To do this, you can simply search the track in the search engine.

Development

For the logs, please use app.logger.info, app.logger.warning or app.logger.error.

Licensing

This project uses Fontawesome icons, which underare Creative Commons Attribution 4.0 International license. The complete license can be found here.