Skip to content

rubenroy/jukebox-ultra-nrv

 
 

Repository files navigation

Jukebox Ultra NRV mkIII

Prerequisites

This application assumes it runs on Linux using Alsa.

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

Installation

  • Clone the repo
  • Move config.py.example to config.py and edit it 😎
  • 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

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.

About

Multi-user jukebox for LAN use

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 44.0%
  • CSS 36.2%
  • HTML 10.6%
  • JavaScript 9.0%
  • TSQL 0.2%