v1.3.0
Swing Music is a beautiful, self-hosted music player for your local audio files. Like a cooler Spotify ... but bring your own music. Just run the app and enjoy your music library in a web browser.
Swing Music is available as pre-compiled binaries for Windows and Linux. Just download the latest release from the downloads page and launch it.
For Linux, you need to make the file executable first.
chmod a+x ./swingmusic
./swingmusic
The app should start at http://localhost:1970 by default. Open it in your browser to use Swing Music. You can change the default port by using the --port
flags.
swingmusic --port 1980
Options are flags that can be passed when starting the app in the terminal to tweak runtime settings or perform tasks. Example: the --port
flag. Read more about options in the docs.
Pull the latest Docker image and run it:
docker pull ghcr.io/swing-opensource/swingmusic:latest
docker run --name swingmusic -p 1970:1970 \
-v /path/to/music:/music \
-v /path/to/config:/config \
--restart unless-stopped \
ghcr.io/swing-opensource/swingmusic:latest
Don't forget to replace /path/to/music
and /path/to/config
with the appropriate values. In addition, specify the the /music
directory as the root directory. Using the Home Directory
option won't work.
For more info, see the Docker section on the docs.
Here's a sample Docker compose file:
services:
swingmusic:
image: swingmusic
container_name: swingmusic
volumes:
- /path/to/music:/music
- /path/to/config:/config
ports:
- "1970:1970"
restart: unless-stopped
This software is provided to you with terms stated in the MIT License. Read the full text in the LICENSE
file located at the root of this repository.
MIT License | Copyright (c) 2023 Mungai Njoroge