yarrbox/README.md

# yarrbox

Configuration tool for docker-compose for my magic machine of goodies.

You need Python 3 installed, but you don't need any extra libraries.  This also
assumes that you're using a recent version of Docker and Docker-Compose.

This might work on macOS Docker, probably not Windows, but you can try I guess.
I'm not sure why you would want to run this on anything other than a big ol'
Linux server though.

**INCOMPLETE: Doesn't do everything I want and is currently kinda useless.**

## Initial Setup

First, generate your personal configuration.

```sh
./yarrbox.py init
```

Next, generate the `docker-compose.yml` file.

```sh
./yarrbox.py generate
```

Then, you can launch everything, make sure to detach from them so you're not
spammed with the output of all these programs.

(This doesn't work yet, not everything is in place.)

```sh
sudo docker-compose up -d
```

## Extras

You can edit the config with `./yarrbox.py edit`, you'll need to regenerate the
config after.  And then all rules of thumb for editing Compose configs applies
after that.  You might want to `down` the containers *just in case*.

## Future work

I'm more than welcome to accept patches to support Kodi.  I'm planning on
migrating to that in the future.  The config tool isn't as advanced to support
different/multiple distribution frontends so you'll have to do that yourself.