christofsteel/syng
christofsteel/syng
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity Actions
syng/README.md

1.4 KiB
Raw Blame History

Syng

Syng is a all-in-one karaoke software, consisting of a backend server, a web frontend and a playback client. Karaoke performers can search a library using the web fronend, and add songs to the queue. The playback client retrieves songs from the backend server and plays them in order.

Currently songs can be accessed using the following sources:

  • Youtube. The backend server queries YouTube for the song and forwards the URL to the playback client. The playback client then downloads the video from YouTube for playback.
  • S3. The backend server holds a list of all file paths accessible through the s3 storage, and forwards the chosen path to the playback client. The playback client then downloads the needed files from the s3 for playback.
  • Files. Same as S3, but all files reside locally on the playback client.

The playback client uses mpv for playback and can therefore play a variety of file formats, such as mp3+cdg, webm, mp4, ...

Installation

Server

pip install git+https://github.com/christofsteel/syng -E server

This installs the server part (syng-server), if you want to self-host a syng server. There is a publicly available syng instance at https://syng.rocks.

Client

pip install git+https://github.com/christofsteel/syng -E client

This installs both the playback client (syng-client) and a configuration GUI (syng-gui).