From 6d14c84e7268b6fb2c014c3347b3e5113ffeedf6 Mon Sep 17 00:00:00 2001 From: Martin Wimpress Date: Tue, 23 Jul 2024 23:07:42 +0100 Subject: [PATCH] docs: add details about --config --- README.md | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index cbf08f2..94260e3 100644 --- a/README.md +++ b/README.md @@ -52,7 +52,7 @@ Stream Sprout is developed on Linux 🐧 and should work on macOS 🍏 or any ot ### Debian - Download the Stream Sprout .deb package from the [releases page](https://github.com/wimpysworld/stream-sprout/releases) 📦️ -- Install it with `apt-get install ./stream-sprout_0.1.3-1_all.deb`. +- Install it with `apt-get install ./stream-sprout_0.1.4-1_all.deb`. ### macOS @@ -81,7 +81,7 @@ See the flake on FlakeHub for more details: ### Ubuntu - Download the Stream Sprout .deb package from the [releases page](https://github.com/wimpysworld/stream-sprout/releases) 📦️ -- Install it with `apt-get install ./stream-sprout_0.1.3-1_all.deb`. +- Install it with `apt-get install ./stream-sprout_0.1.4-1_all.deb`. ### From source @@ -96,13 +96,23 @@ cd stream-sprout Copy the [example Stream Sprout configuration](https://github.com/wimpysworld/stream-sprout/blob/main/stream-sprout.yaml.example) and edit it to suit your needs 📝 -Stream Sprout will look for a configuration file in the following locations, in this order: +You can specify the configuration file to use with the `--config ` option. +If you don't specify a configuration file, Stream Sprout will look for a configuration file in the following locations, in this order: + - Current working directory `./stream-sprout.yaml` - XDG configuration directory `$XDG_CONFIG_HOME/stream-sprout.yaml` (*Linux*) or `~/.config/stream-sprout.yaml` (*macOS*) - `/etc/stream-sprout.yaml` ### Server +```yaml +server: + url: "rtmp://127.0.0.1:1935" + key: "create your key with uuidgen here" + archive_stream: false + archive_path: "${HOME}/Streams" +``` + The `server:` section is used to configure the RTMP server that Stream Sprout creates; it must be an RTMP URL. The default port for RTMP is `1935`, but you can use any port you like. If you remotely host Stream Sprout, you should use an IP address in the `url:` that accessible by your computer that runs OBS Studio and also set `key:` to a secure value to prevent unauthorized access. @@ -113,14 +123,6 @@ If `archive_path:` is not accessible, Stream Sprout will fallback to using the c Here's an example configuration for the Stream Sprout `server:` section. -```yaml -server: - url: "rtmp://127.0.0.1:1935" - key: "create your key with uuidgen here" - archive_stream: false - archive_path: "${HOME}/Streams" -``` - ### Services `services:` are arbitrarily named.