Files
nowblinkie/readme.md

40 lines
1.1 KiB
Markdown

# nowblinkie
generate dynamic blinkies to use on your website,
using the output of arbitrary commands.
nowblinkie does not host a web server,
you must use a separate webserver to host your blinkies,
such as nginx or caddy.
## usage
1. install requirements: `pip install -r requirements.txt`
2. run: `python main/src.py [-c config-file] [-L]`.
## docker
a [dockerfile](./Dockerfile) and [compose file](./compose.yaml) have been provided.
keep in mind the commands will run in the docker container, too.
you do not need to clone this repository to use the compose file provided.
### custom images
to use utilities not installed in the standard docker image,
you can build a new one based off of it:
```dockerfile
FROM https://git.alv.cx/alvierahman90/nowblinkie.git
RUN apt-get update && apt-get install blahblahblah
CMD [ "python", "-u", "./src/main.py", "-c", "/config.toml" ]
```
## config
the provided [example config file](./config.toml) lists all the options that can be used.
the blinkie templates and the font
([curie](https://github.com/oppiliappan/curie))
required to render them are included in the repository.