koel logo

koel

Personal music streaming server with a sleek web player

Replaces
Spotify
17k PHP MIT 2 days ago

Overview

Koel is a personal music streaming application with a PHP/Laravel backend and a Vue.js single-page frontend. It scans a directory of audio files, builds a library with last.fm metadata, and streams them through a polished browser-based player supporting playlists, favorites, and search. It also exposes a Subsonic-compatible API for use with mobile clients. Deployment requires a web server, PHP, and a database (MySQL/PostgreSQL/SQLite).

Where it falls short of Spotify

  • Requires PHP runtime and a relational database, adding operational overhead vs. single-binary alternatives.
  • No native mobile apps; mobile access relies on third-party Subsonic clients.
  • No algorithmic recommendations or social/collaborative features like Spotify.
  • Podcast support is absent; music library files only.

We list the gaps honestly so you can decide if the trade-off is worth owning your data.

Tags

music-server
audio-streaming
self-hosted
php
web-player
Maintain koel?

Claim this listing to keep it accurate, add a deploy template, or feature it on relevant pages.

Show off your self-host difficulty score

Embed the koel difficulty badge in your README — it links back here.

Self-host difficulty badge← add this to your README
[![Self-host difficulty](https://openreplace.com/api/badge/koel)](https://openreplace.com/koel)

Similar open-source projects

Other self-hostable tools in the same space worth comparing.

Free open-source media server — a self-hosted Plex alternative

53k C# GPL-2.0 yesterday
2/5
koel vs Jellyfin

High-efficiency real-time video server supporting RTMP, WebRTC, HLS, and SRT

29k Docker MIT 20 days ago
3/5
koel vs SRS

Modern self-hosted music server compatible with Subsonic/Airsonic clients

22k Docker GPL-3.0 today
2/5
koel vs Navidrome Music Server

Open-source home theater media center for local and network playback

21k C++ GPL-2.0 today
2/5
koel vs Kodi