Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


The source files for the EternalJukebox, a rehosting of the Infinite Jukebox.
This repo contains everything you need to host the EternalJukebox on your own server!

You can visit the official site here, in case you want to mess around with it without doing all the hard stuff.

Docker Install


You need to install docker and docker-compose

Then, download or clone the repository.


To configure, rename .env.example to .env and change the appropriate values. For advanced configuration edit envvar_config.yaml.


To start, run docker-compose up -d in the repositories directory. To stop, run docker-compose down.

If you change anything in the repository, like pulling updates, run docker-compose build to re-build the application.

If you want to change the port from 8080, edit docker-compose.yml line 9, to be - <your port>:8080

Manual Install




Download and install Java from

Debian-based Linux distributions

For Ubuntu or Debian-based distributions execute sudo apt-get install default-jre in the terminal

Fedora and CentOS

There is a tutorial for installing java on Fedora and CentOS at

Yt-dlp (a more up-to-date fork of Youtube-dl):


Download the .exe at and place it in C:\Windows\, or in another folder on the PATH.


Use these commands in the terminal to install youtube-dl on Linux:
sudo curl -L -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp



Download the exe from and place it in C:\Windows\, or in another folder on teh PATH.


ffmpeg is available to download in most distributions using sudo apt-get install ffmpeg or equivalent

Getting the project files:

The whole process of obtaining project files is much easier now, as the build process is streamlined through Jenkins.

The project site is over here, and contains the individual files to download, or an all-in-one zip for all the files. Alternatively, the files can be found over at a permanent server here


First thing to do is create a new file called either config.yaml or config.json (YAML tends to be easier to write, but takes up slightly more space), then open it with notepad/notepad++ on Windows and whatever text editor you like on Linux (for example nano: nano config.json)

Now you should go to and log in to your spotify account.
Then click the "Create an app" button and a new page should popup.
There give it a name and description and click create.
It should send you to the new app's page, the only thing you need from here is your Client ID and Client Secret
(Note: Never share these with anyone!)

You will also need a Youtube Data API key, which you can find about how to obtain here.

There are a variety of config options (documentation coming soon) that allow most portions of the EternalJukebox to be configured, and these can be entered here.

Starting the server:

First you need to open the Terminal or Command Prompt.
Then make sure its running in the folder that your EternalJukebox.jar is in, once again to do this use the cd command.
Then execute the jar with java -jar EternalJukebox.jar

If everything went right it should say Listening at

you should now be able to connect to it with a browser through http://localhost:11037

Congrats you did it!

Manually Building

This is not recommended unless you're making some modifications, and as such should only be performed by more advanced users

You'll need to obtain a copy of Gradle, likely a JDK, and Jekyll. You'll also need the project files in some capacity, be it git clone or downloading the archive from GitHub.

From there, building in Gradle is simple; just run gradle clean shadowJar from the project file directory. That should produce a jar file in build/libs that will work for you. In addition, you'll need to build the Jekyll webpages, which can be done by running jekyll build --source _web --destination web


The internal workings for the Eternal Jukebox, a rehosting of the Infinite Jukebox







No releases published


No packages published