Plays your music collection over the web in your browser.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Semira’s music

What is this?

A simple application to stream audio from your server to your browser for listening. It provides a HTML5 frontend to audio files (MP3, FLAC, OGG, M4A) for searching and playing. The files are recoded before streaming them to save bandwidth and be compatible with the browser you are using.

How does it work?

This application is build using Clojure and ClojureScript to handle user requests and uses GStreamer to recode audio files. The recoded audio files are cached for later use.


The source directory includes a Dockerfile to build a docker image;

lein uberjar
docker build -t semira .
docker run -p 8080:8080 -v $HOME/Music:/home/app/Music:ro semira

When Jetty reports it is listening on port 8080, hit the /update location to index the MP3, FLAC, OGG and M4A files in your home Music directory. The /update location will redirect to / after a few seconds while the indexer continues to collect the audio meta data.


Copyright (c) Remco van ‘t Veer. All rights reserved.

The use and distribution terms for this software are covered by the Eclipse Public License 1.0 ( which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.