From 60a3f7bf15c43182dfc5797fce27b603c104db02 Mon Sep 17 00:00:00 2001
From: Jakob Stendahl <jakob.stendahl@outlook.com>
Date: Mon, 24 Jan 2022 14:18:47 +0100
Subject: Initial commit

---
 Readme.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 Readme.md

(limited to 'Readme.md')

diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..691963c
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,36 @@
+# RSS-watcher
+Simple rust app that periodically checks RSS feeds for new entries,
+and pushes those to Gotify.
+
+## Usage
+This can be run using docker or locally, to run with docker you can
+```
+$ docker build -t rss-watcher .
+$ docker run -it --rm -e DB_HOST=<database host> -e DB_USER=<database user> \
+         -e DB_PASS=<database password> -e DB_BASE=<database name> rss-watcher
+```
+To run locally you need to set all those environment variables, and then
+you can run it with
+```
+$ RUST_LOG=info cargo run
+```
+
+All feed have to be defined in the database, you should start the app and let
+it create the table(s) itself. Then you can add feeds like this
+```sql
+INSERT INTO `rss-watcher-feeds` (url, push_url, push_token)
+     VALUES (<the url of the RSS/Atom feed>,
+             <root url of gotify server e.g. https://push.example.com>,
+             <token for gotify app>);
+```
+You can also specify what fields should be used in the title and message fields
+of the gotify notification by changing the `title` and `message` columns.
+By default they are set to `{{title}}` and `{{summary}}` respectively.
+
+Also, if you set the env var `FETCH_INTERVAL`, it will change how often it 
+will poll for new changes (in ms).
+
+## Todo
+- Extract more RSS fields.
+- Deal with multiple links.
+- Add proper error handling for gotify failures
-- 
cgit v1.2.3