Personal music streaming server with a modern web player

16.9kstars
2.1kforks
Last commit: 7h ago
Repo age: 11y old
Koel screenshot

Koel is a web-based personal music streaming server that indexes your existing audio files and lets you stream them from anywhere through a modern browser UI. It focuses on a simple, fast library experience—searching, queuing, and playlisting—while keeping your collection under your control.

Key Features:

  • Scans and indexes local audio libraries into a searchable music catalog
  • Modern web player with queue management, browsing, and fast search
  • Playlist management (create, edit, reorder) for organizing listening
  • Multi-user support with authentication for shared servers
  • Artist/album/track browsing with artwork and metadata display
  • Mobile-friendly web UI suitable for phone/tablet streaming
  • Backend API used by the web UI (useful for integrations)

Use Cases:

  • Stream a personal FLAC/MP3 library at home or while traveling
  • Provide a shared music server for a family or small community
  • Centralize music on a NAS/server and play from any device via browser

Limitations and Considerations:

  • Requires correct filesystem permissions and a supported PHP/Laravel runtime; initial library scanning can take time on large collections
  • Primarily focused on browser-based playback; native app ecosystems may rely on third-party clients/integrations

Koel is a practical choice for users who want a polished “personal Spotify-like” experience on top of their existing music files. It emphasizes a clean UI, fast library navigation, and straightforward administration for running your own music server.

Categories:

Tags:

Tech Stack:

Share:

Similar Services

Jellyfin

Jellyfin

Personal media server for movies, TV, music, and photos

47.5k
4.3k
Last commit: 3d ago

Self-hosted media server to organize, stream, and transcode your movies, TV, music, and photos across apps and devices.

Alternative to:
Plex
Plex
+1
AudioBookshelf

AudioBookshelf

Self-hosted audiobook and podcast server

11.3k
816
Last commit: 15d ago

Stream and manage audiobooks and podcasts with metadata matching, progress sync, and mobile/web apps.

Alternative to:
Plex
Plex
+1
Lidarr

Lidarr

Music collection manager for Usenet and BitTorrent users

4.9k
323
Last commit: 10d ago

Automate music downloading, importing, and library organization with artist monitoring, release tracking, quality profiles, and integrations for indexers and download clients.

Alternative to:
Roon
Roon
+1
Your Spotify

Your Spotify

Spotify listening analytics dashboard you can host yourself

4.1k
176
Last commit: 17d ago

A self-hosted web app that connects to Spotify and shows your listening stats, top tracks/artists, and personalized insights over time.

Alternative to:
Spotify
Spotify
+2
Black Candy

Black Candy

Self-hosted music streaming server for your personal library

4.1k
206
Last commit: 1mo ago

Black Candy is a self-hosted music server for organizing a personal library and streaming it from a web interface, with playlists, search, and metadata browsing.

Alternative to:
Spotify
Spotify
+4
Ampache

Ampache

Web-based audio streaming and music library manager

3.7k
607
Last commit: 4h ago

Self-hosted web app to catalog your music and stream it anywhere via web UI, Subsonic-compatible API clients, playlists, and user access controls.

Alternative to:
Spotify
Spotify
+7