Skip to content

A java based server to provide songs, videos and lyrics for karaoke machines like UltraStar Play

License

Notifications You must be signed in to change notification settings

supernevi/KaraokeProvider

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Set songs directory

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.

Set server credentials

This server is secured by basic authentication which can be configured by the runtime parameters -Dspring.security.user.name=<username> and -Dspring.security.user.password=<password>

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.

About

A java based server to provide songs, videos and lyrics for karaoke machines like UltraStar Play

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Languages