🦔 sanic

chaos music control inspired by relaxx player

✨ Features

• mpd web gui
  • search music
  • organize playlists
  • control current playback queue
• no authentication required to control music playback
• add playlists from internet radios (*.m3u, *.pls)
• add music from other sources like youtube (youtube-dl)

Installation

NixOS (flakes)

Example flake setup (untested):

{
  description = "my host";
  inputs ={
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-23.11";
    sanic.url = "git.berlin.ccc.de:cccb/sanic/latest";
  };
  outputs = { self, nixpkgs, sanic }:
  let
    system = "x86_64-linux";
    pkgs = import nixpkgs { inherit system; };
  in
  {
    nixosConfigurations."myhostname".nixpkgs.lib.nixosSystem {
      inherit system;
      modules = [
        sanic.nixosModules.sanic
        {
          sanic = {
            mpd = {
              host = "localhost";
              port = 6600;
            };
            ui = {
              hostname = "[::]";
              port = "443";
              tls = true;
            };
          };
        }
      ];
    };
  };
}

Arch Linux (Manjaro, etc)

Install from the AUR:

yay -S sanic

Debian (Ubuntu, Mint, etc)

tba

Red Hat (Fedora, Rocky Linux, etc)

tba

Windows / macOS

lol! 🤣

🛠️ Development

sanic is developed using Nix, but you can also just use the usual Golang tooling.

Run local MPD instance for testing with make mpd.

Update go depdendencies like this:

go get -u  # or `make update`
go mod tidy  # or `make tidy`
gomod2nix

❄️ w/ Nix

Enter development shell (also has mpc client installed for testing):

nix develop

Build nix flake:

nix build

🐧 w/o Nix

Use these Make targets for convenience:

• run: Run project
• build: Compile project
• tidy: Add missing and remove unused modules
• verify: Verify dependencies have expected content
• format: Format go code
• lint: Run linter (staticcheck)
• test: Run tests
• cert: Create https certificate for local testing

🐳 Container

You can run sanic in a container. Use these Make targets for convenience:

• build-container: Build container image
• run-container: Run container image

🗺️ Architecture

---

Made with ❤️ and .