Swing Music

Swing Music is an open-source, self-hosted music streaming server designed for managing and playing local audio files. It provides a centralized web interface for library organization and playback, allowing users to host their own music collection on a private server rather than relying on external cloud services. The system focuses on organizing local storage into a structured streaming experience.

The application is deployed as a server that can be installed via a shell script on Linux and MacOS or as a portable build on Windows. It also supports deployment through Docker and Docker Compose for containerized environments. Once the server is running, users access the music library through a web browser or a dedicated Android mobile client to stream audio from the host machine to other devices.

Key features

• Daily mixes curated based on listening activity
• Metadata normalization for library consistency
• Album versioning for labels such as Deluxe or Remaster
• Folder view for browsing music by directory structure
• Silence detection combined with cross-fade
• Listening activity statistics and insights
• Last.fm scrobbling integration
• Multi-user support
• Collections to group artists and albums

The server is built using Python and Vue, supporting x86 and arm64 architectures. It manages local files by mapping music and configuration directories to the server instance, ensuring that the original file structure remains intact while the software layers a management interface on top. The system includes tools for metadata normalization and the ability to associate related artists and albums within the library to improve discoverability. Configuration is handled via environment variables, such as setting the device name and network port during the Docker deployment process.

Swing Music is intended for users who prefer to maintain full ownership of their audio files while accessing them via a modern streaming interface across multiple platforms.