escarpolette 0.2.0

Manage your musical playlist with your friends without starting a war.

Escarpolette

This project provides a server and clients to manage your music playlist when you are hosting a party.

It supports many sites, thanks to the awesome project youtube-dl.

Features

Server:

• add items (and play them!)
• get playlist's itmes
• runs on Android! (see instructions)

Web client:

• there is currently no web client :(

Dependencies

• Python 3.6
• the dependencies manager Poetry
• the player mpv

They should be available for most of the plateforms.

Installation

pip install escarpolette
# generate a random secret key
echo "SECRET_KEY = '$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)'" > config.cfg

Android

You will need Termux. Then inside Termux you can install it with:

# dependencies
pkg install python python-dev clang
# escarpolette
pip install escarpolette

Note that while the project can run without wake-lock, acquiring it improve the performance (with a battery trade off).

Usage

escarpolette --config config.cfg

Todo

• server
  • empty the playlist on startup
  • bonjour / mDNS
  • votes
  • prevent adding youtube / soundcloud playlists
  • restrictions by users
  • configuration of those restrictions by an admin
• web client
  • show playing status
  • votes
  • configure restrictions:
    • max video added per user
    • max video length
  • admin access:
    • configure restrictions
    • no restrictions for him
    • force video order

Don't count on it:

• android client
• iOS client