From ce6e8ecf216b1c5fd5ff7ad3ab0e99b42e50ca1b Mon Sep 17 00:00:00 2001
From: Ricardo Band <email@ricardo.band>
Date: Mon, 22 Jan 2024 13:10:30 +0100
Subject: [PATCH] stylish readme

---
 Makefile   |  2 +-
 README.md  | 47 ++++++++++++++++++++++++++++++++++++++++-------
 config.ini |  2 +-
 3 files changed, 42 insertions(+), 9 deletions(-)

diff --git a/Makefile b/Makefile
index a3b4c83..73db29e 100644
--- a/Makefile
+++ b/Makefile
@@ -10,7 +10,7 @@ mpd:  ## Run mpd test instance
 	mpd --no-daemon ./mpd.conf
 
 run: build  ## Run project
-	./server
+	./${PROJECT}
 
 build:  ## Compile project
 	go build -v -o ${PROJECT}
diff --git a/README.md b/README.md
index 035a411..5b5cd45 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,32 @@
 [![maintained](https://img.shields.io/maintenance/yes/2024)]()
 
-# sanic
+# 🦔 sanic
 
 chaos music control inspired by [relaxx player][relaxx]
 
-
-## features
+## ✨ Features
 
 - mpd web gui
   - search music
   - organize playlists
   - control current playback queue
 - no authentication required to control music playback
-- add music from other sources like youtube (`youtube-dl`)
 - add playlists from internet radios (`*.m3u`, `*.pls`)
+- add music from other sources like youtube (`youtube-dl`)
 
-## development
+## 🛠️ Development
+
+sanic is developed using [Nix][nix], but you can also just use the usual Golang tooling.
+
+Run local [MPD][mpd] instance for testing with `make mpd`.
+
+### ❄️ w/ Nix
+
+Enter development shell (also has [mpc][mpc] client installed for testing):
+
+```shell
+nix develop
+```
 
 Build nix flake:
 
@@ -23,12 +34,34 @@ Build nix flake:
 nix build
 ```
 
-## architecture
+### 🐧 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
+- `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
 
 [![Architecture](https://git.berlin.ccc.de/cccb/sanic/raw/branch/main/architecture.drawio.svg)](https://app.diagrams.net/?mode=git.berlin.ccc.de#Hcccb%2Fsanic%2Fmain%2Farchitecture.drawio.svg)
 
 ---
 
-Made with ❤️ and 🐍.
+Made with ❤️ and ![golang logo][golang].
 
 [relaxx]: http://relaxx.dirk-hoeschen.de/
+[nix]: https://nixos.org/manual/nix/stable/
+[golang]: https://go.dev/images/favicon-gopher.svg
+[mpd]: https://musicpd.org/
+[mpc]: https://www.musicpd.org/clients/mpc/
diff --git a/config.ini b/config.ini
index fb5ddb1..132ef26 100644
--- a/config.ini
+++ b/config.ini
@@ -5,7 +5,7 @@ port = 6600
 #pasword =
 
 [ui]
-hostname = 0.0.0.0
+hostname = [::1]
 port = 8080
 tls = no
 cert = cert.pem