Skip to content

Latest commit

 

History

History
28 lines (21 loc) · 1.87 KB

README.md

File metadata and controls

28 lines (21 loc) · 1.87 KB

Build Status Codacy Badge

KaraokeProvider

KaraokeProvider is a free and open source java based server to provide audio, video files and lyrics, cover and background images for your karaoke machine. This project was created based on UltraStar Play, but basically you can host your files for what you ever want.

How to use

This project requires Java 17 and for hosting Tomcat 10.1.x.

Get or build your war file

As long as no releases are present you have to checkout this project and build it manually with maven. The output is a war-file in your target folder that can be used in your tomcat server.

Starting the tomcat server

Start your tomcat with following runtime start parameter -DsongStorePath=<absolutePathToYourSongFolder> The server starts scanning all your files in that directory for UltraStar based text files and then provides this text file and all accociated media files (audio, video, cover, background) as far as they are configured and exists.

REST API

Providing happens via REST. Current specifications can be found here

Limitations

  1. maximum file size for streaming is 2GB (due to technical reasons)

Contributing

I'm grateful for any contribution. So don't resitate to create or implement issues.