🎵 Open Source & Free Forever

Your Music.
Your Server.

SonaFly is a self-hosted music streaming server that puts you in control. Stream your library from anywhere with a sleek web UI and cross-platform mobile app.

Get Started View on GitHub
7+ Audio Formats
3 Platforms
∞ Your Music
WHY SONAFLY

Everything you need to
own your music

No subscriptions. No algorithms. No data harvesting. Just your music, streamed your way.

📱

Cross-Platform App

Native Android & iOS app built with .NET MAUI. Browse, search, stream, and build playlists from your pocket.

🌐

Web Admin Panel

A beautiful React admin UI to manage your library, users, content restrictions, and auditorium rooms from any browser.

🔍

Instant Search

Full-text search across tracks, albums, and artists. Find anything in your library in milliseconds.

🖼️

Automatic Artwork

Extracts embedded album art and automatically fetches missing covers from MusicBrainz Cover Art Archive.

📋

Playlists & Mixed Tapes

Create playlists with drag-and-drop, or let Mixed Tapes auto-fill a set duration from your library.

👥

Multi-User & Roles

Role-based access control with admin and user tiers. Restrict content per-user for family-friendly setups.

🐳

Docker Deploy

Single container, one docker compose up, and you're streaming. SQLite database — no external dependencies.

🔒

Secure by Default

JWT authentication, refresh tokens, encrypted passwords. Refuses to start in production with insecure keys.

SHARED LISTENING

The Auditorium

Create shared listening rooms where everyone hears the same music, perfectly synced. Queue songs, invite friends, and experience your collection together — no matter where they are.

🎵
Synced Playback Join mid-song and get synced to the exact position (~1 sec accuracy)
📋
Collaborative Queue Anyone can queue songs — up to 100 tracks in the queue
⏸️
Auto Pause & Resume Music pauses when the room empties and resumes when someone joins
🔄
Auto Advance Queue plays continuously — next track starts automatically
Rock Lounge 3 listeners
Master of Puppets
Metallica
UP NEXT
♪
Holy Wars
Queued by Dave
♪
Hallowed Be Thy Name
Queued by Bruce
COMPATIBILITY

All your formats, covered

From lossless audiophile FLAC to lightweight Opus — SonaFly streams them all.

.mp3
MP3
audio/mpeg
.flac
FLAC
Lossless
.m4a
AAC / M4A
audio/mp4
.ogg
OGG Vorbis
audio/ogg
.opus
Opus
audio/ogg
.wav
WAV
audio/wav
.aac
AAC
audio/mp4
BUILT WITH

Modern tech stack

ASP.NET Core 10
Backend API
React + TypeScript
Web Admin UI
.NET MAUI
Mobile App
SQLite
Database
SignalR
Real-time Sync
Docker
Deployment
GET STARTED

Up and running in 3 minutes

1

Clone

git clone https://github.com/ExythAI/SonaFly.git
2

Configure

cd SonaFly/docker && cp .env.example .env

Set your JWT_SECRET and mount your music folders in docker-compose.yml.

3

Launch

docker compose up -d --build

SonaFly starts at http://your-server:8080. Log in as admin / Admin123!, add your library roots, and scan.

YOUR MUSIC, YOUR RIGHTS

Built for music you own

SonaFly is a personal streaming tool designed for legally acquired music collections.

⚖️

Respect Copyright

SonaFly is designed exclusively for streaming music you have legally purchased, ripped from CDs you own, or created yourself. Distributing or sharing copyrighted music without authorization is a violation of copyright law in most jurisdictions.

This software does not facilitate, condone, or enable piracy. The developers assume no responsibility for misuse. By using SonaFly, you agree to stream only content you have the legal right to access.

✓ Music purchased from iTunes, Bandcamp, Amazon, etc.
✓ CDs ripped from your personal collection
✓ Music you've created or have a license to use
✓ Royalty-free and Creative Commons music
🎶

Create Your Own Music

Here's the exciting part — you don't need to buy music to fill your library. A new wave of AI music generation tools lets you create professional-quality, original tracks that are entirely yours to keep and stream.

🎵 Suno
Generate full songs from text prompts — vocals, instruments, and production included. Create any genre in seconds.
🎧 Udio
High-fidelity AI music generation with nuanced vocal performances and studio-quality production.
🎤 Boomy
Create and release original songs in minutes. Simple interface, powerful output.

Generate your tracks, download them, and stream through SonaFly — your own private music catalog, 100% original and 100% yours.

Take back your music

SonaFly is free, open source, and always will be. No tracking, no subscriptions — just pure music streaming that you own.

Star on GitHub