siren: A Go repository from alicebob

Browser based MPD client.

Made with Svelte and display:grid.

Releases

Binary releases are on the releases page.

History

Version 1.0 was with Elm 0.18.
Version 2.0 was with Purescript.
Version 3.0 was plain Javascript.
Version 4.0 is svelte and esBuild.

Build

you need a Go (>=1.16)
make
run the binary from ./siren
open http://localhost:6601/

All resources are bundled in the binary, so you can copy it over to other machines.

The UI files are stored compiled in the repo, so there is no need to install anything. See the Makefile in the ./ui/ dir how to update the JavaScript.

Raspberry Pi build

Thanks to Go's cross-platform support you can build Siren on your laptop, and copy the executable to your Raspberry Pi.

you need a Go compiler on your laptop
make build-pi
copy siren/siren to your Raspberry Pi
open http://your_raspberry:6601/

Running

Siren connects to the mpd at localhost:6600 by default. Change it with for example: ./siren -mpd=192.168.1.2:6600

If you don't want to make Siren available to everyone in your subnet, use: ./siren -listen=localhost:6601

Artist vs Albumartist

By default Siren uses the albumartist field for the artist browse screen. If you want to use the artist instead field you can specify that with: ./siren -albumartist=false.

NGINX

Suggested nginx config:

        location /siren/ { 
                location /siren/mpd/ws { 
                        proxy_set_header Upgrade $http_upgrade; 
                        proxy_set_header Connection "upgrade"; 
                        proxy_http_version 1.1; 
                        proxy_set_header Host $host; 
                        proxy_pass http://127.0.0.1:6601/mpd/ws; 
                } 
                proxy_pass http://127.0.0.1:6601/; 
        }

Development

Usually the CSS and Javascript files are embedded in the executable, but you can use the filesystem while developing. Run siren with:

./siren/siren --docroot ./docroot

alicebob/siren