A lightweight, self-hosted music streaming server implementing some of the Subsonic API and OpenSubsonic extensions, written in Rust.

Note This is a personal use project built to fit specific needs. As a result, not all endpoints from the full Subsonic API specification are implemented. It includes the most commonly used features for streaming music and managing libraries. For production use cases requiring comprehensive API coverage, consider using Navidrome or other established Subsonic implementations.

• Subsonic API Compatible - Works with any Subsonic-compatible client (DSub, Symfonium, Submariner, etc.)
• OpenSubsonic Extensions - Supports modern extensions like API key authentication and form POST
• Fast & Lightweight - Built with Rust, Axum, and SQLite for minimal resource usage
• Easy Setup - Single binary with SQLite database, no external dependencies
• Music Library Scanning - Automatically scans and indexes your music collection
• User Management - Multi-user support with role-based permissions

# Clone the repository
git clone https://github.com/momoyaan/subsonic.git
cd subsonic

# Build with Cargo
cargo build --release

# The binary will be at target/release/subsonic

nix develop  # Enter development shell
cargo build --release

# 1. Create an admin user
./subsonic create-user --username admin --password yourpassword --admin

# 2. Add your music folder
./subsonic add-folder --name "Music" --path /path/to/your/music

# 3. Scan your library
./subsonic scan

# 4. Start the server
./subsonic serve

The server will start on http://localhost:4040 by default.

Usage: subsonic [OPTIONS] [COMMAND]

Commands:
  create-user       Create a new user
  generate-api-key  Generate an API key for a user
  revoke-api-key    Revoke (delete) an API key for a user
  show-api-key      Show a user's API key
  add-folder        Add a music folder
  list-folders      List all music folders
  remove-folder     Remove a music folder
  scan              Scan music folders for audio files
  serve             Start the server (default)

Options:
  -d, --database <FILE>  Database file path [default: subsonic.db]
  -p, --port <PORT>      Server port [default: 4040]
  -h, --help             Print help

• RUST_LOG - Set log level (e.g., subsonic=debug,tower_http=debug)

The server supports three authentication methods:

1. Token Authentication (recommended) - MD5(password + salt) via t and s parameters
2. API Key (OpenSubsonic) - Via apiKey parameter
3. Legacy Password - Plain or hex-encoded via p parameter

The scanner recognizes the following formats:

• FLAC, MP3, AAC/M4A, OGG/Opus, WAV, AIFF, WMA, APE, WavPack

Tested with:

• Symfonium (Android)
• DSub (Android)
• Submariner (macOS)
• Sonixd (Desktop)
• Feishin (Desktop)

# Enter nix development shell (includes Rust toolchain)
nix develop

# Run in development mode
cargo run -- serve

# Run tests
cargo test

# Check formatting
cargo fmt --check

# Run linter
cargo clippy

src/
├── main.rs          # CLI and server entry point
├── lib.rs           # Library exports
├── api/             # Subsonic API implementation
│   ├── auth.rs      # Authentication middleware
│   ├── handlers/    # API endpoint handlers
│   └── response.rs  # Response formatting (XML/JSON)
├── db/              # Database layer (Diesel + SQLite)
├── models/          # Domain models
├── scanner/         # Music library scanner
└── crypto/          # Password hashing

MIT License - see LICENSE for details.

• Subsonic - Original API specification
• OpenSubsonic - Modern API extensions
• Navidrome - Inspiration for implementation