From 3288d71c91795522b96f32bd8a5c3703a6ae4ec6 Mon Sep 17 00:00:00 2001 From: evilchili Date: Fri, 1 Mar 2024 01:14:24 -0800 Subject: [PATCH] updating readme --- README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 471415f..c3b1771 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,56 @@ -# dnd-music-console -Controller for icecast / liquidaudio with helpers for D&D session music +# Croaker +A command-and-control web application for icecast / liquidaudio, with helpers for D&D session music. + +## What? Why? + +Because I run an online D&D game, which includes a background music stream for my players. The stream is controlled by a bunch of bash scripts I cobbled together which are functional but brittle. Also, this currently requires me to have a terminal window open to my media server to control liquidsoap directly, and I'd rather integrate the music controls directly with the rest of my DM tools, all of which run on my laptop. A web-based commmand-and-control app lets me use vanilla HTTP requests to control liquidsoap. + +*Now that is a powerful yak! -- Aesop Rock (misquoted)* + + +## Quick Start (Server) + +This assumes you have a functioning icecast2 installation already. + +``` +% mkdir -p ~/.dnd/croaker +% croaker setup > ~/.dnd/croaker/defaults +% vi ~/.dnd/croaker/defaults # adjust to taste +% croaker add session_start /music/session_start.mp3 +% croaker add battle /music/battle/*.mp3 +``` + +Now start the server, which will begin streaming the `session_start` playlist: + +``` +% croaker start +Daemonizing webserver on http://0.0.0.0:8003, pidfile and output in ~/.dnd/croaker +``` + +## Quick Start (Client) +``` +% mkdir -p ~/.dnd/croaker +% croaker setup > ~/.dnd/croaker/defaults # only the client config is required +% vi ~/.dnd/croaker/defaults # adjust to taste +``` + +Switch to battle music -- roll initiative! + +``` +% croaker play battle +OK +``` + +Skip this track and move on to the next: + +``` +% croaker skip +OK +``` + +Stop the server: + +``` +% croaker stop +OK +```