Skip to content

Getting Started

Installing Swing Music

Swing Music is available as precompiled binaries for both Windows and Linux.

Download the latest binary file from the download page and run it. That's all of it.

For Linux users, you need to make the file executable using chmod to run it.

Something like this.

sh
chmod +x ./swingmusic
chmod +x ./swingmusic

Docker

Pull the Docker image and run it.

sh
docker pull ghcr.io/swing-opensource/swingmusic:latest
docker pull ghcr.io/swing-opensource/swingmusic:latest

Replace /path/to/music with your music location and /path/to/config with the path you want the config to be created.

sh
docker run --name swingmusic -p 1971:1970 \
-v /path/to/music:/music -v /path/to/config:/config \
--restart unless-stopped ghcr.io/swing-opensource/swingmusic
docker run --name swingmusic -p 1971:1970 \
-v /path/to/music:/music -v /path/to/config:/config \
--restart unless-stopped ghcr.io/swing-opensource/swingmusic

You can use multiple music folders by mounting them to /music.

sh
-v /path/1:/music -v /path/2:/music
-v /path/1:/music -v /path/2:/music

You can pass Swing Music options at the end of the docker run command.

sh
--restart unless-stopped ghcr.io/swing-opensource/swingmusic --help # print help text
--restart unless-stopped ghcr.io/swing-opensource/swingmusic --help # print help text

Options

Options are flags that can be passed when starting the app in the terminal to tweak runtime settings or perform tasks.

OptionShortDescription
--help-hShow this help message
--version-vShow the app version
--hostSet the host
--portSet the port
--configSet the path to create the config folder
--no-periodic-scan-npsDisable periodic scan
--scan-interval-psiSet the periodic scan interval in seconds. Default: 600 seconds (10 minutes)
--buildBuild the application (in development)

A labor of love built by Mungai Njoroge