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 items
• runs on Android! (see instructions)

Web client:

• there is currently no web client :(

Dependencies

• Python 3.7
• the player mpv

They should be available for most of the plateforms.

Installation

pip install escarpolette

Android

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

# dependencies
pkg install python python-dev clang mpv
# 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] [--host host] [--port port] [--help]

The default configuration should be good for all the usages.

Dev

You will need Poetry to manage the dependencies.

Clone the repo and then type poetry install. You can run the app with poetry run python -m escarpolette.

Todo

• server
  • votes
  • bonjour / mDNS
  • 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

Maybe one day?

• android client
• iOS client