From a7438fbe77ec3714ca3c00c54128f608344628f7 Mon Sep 17 00:00:00 2001 From: Michael Grote Date: Mon, 10 Apr 2023 18:52:51 +0200 Subject: [PATCH] Syntax + Docs --- README.md | 46 ++++++++++++++++++++++++++-------------------- 1 file changed, 26 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 64aee04..786ee9e 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,5 @@ # miniflux-filter -[![Build Status](http://docker9.grote.lan/api/badges/Docker-Images/miniflux-filter/status.svg)](http://docker9.grote.lan/Docker-Images/miniflux-filter) - ### Table of Contents * [Introduction](#introduction) @@ -16,15 +14,18 @@ ### Introduction + ``miniflux-filter`` is a small bash-script for [miniflux](https://miniflux.app) that marks certain articles as read, if the search conditions are met. ### Getting Started + 1. create an [api-key](https://miniflux.app/docs/api.html#authentication) in miniflux 2. create a [compose-file](./docker-compose.yml) 3. create a [filter-file](./filter.txt) 4. ````docker-compose up```` #### example docker-compose + ```yaml version: '3.2' services: @@ -32,10 +33,10 @@ services: container_name: mf-filter restart: always environment: - - TZ=Europe/Berlin - - MF_AUTH_TOKEN=XN2klsvvD[...]-dcHPaeQ= - - MF_API_URL=https://miniflux.[...].net/v1 - - MF_SLEEP=60 + TZ: Europe/Berlin + MF_AUTH_TOKEN: XN2klsvvD[...]-dcHPaeQ= + MF_API_URL: https://miniflux.[...].net/v1 + MF_SLEEP: 60 #- MF_DEBUG=1 image: quotengrote/miniflux-filter:latest volumes: @@ -43,6 +44,7 @@ services: ``` #### example filter-file + * Format: `url::search` * case-insensitive @@ -57,32 +59,36 @@ heise.de::TechStage | ``` ## Misc + - [tborychowski/miniflux-filter](https://github.com/tborychowski/miniflux-filter) - [jqplay.org](https://jqplay.org) - To clean up your `filter.txt` you can use the following script: `./sort_and_remove_double_lines.sh` ### Debug + If `MF_DEBUG` is set to `1`, `miniflux-filter` will print extra output to stdout. - the current Variable - URL + Values for filtering - almost all function calls #### Exit-Codes -| RC | Description | -| -- | -- | -| 1 | `$MF_FILTERLIST_FILE` not found | -| 2 | `$MF_AUTH_TOKEN` not set | -| 3 | `$MF_API_URL` not set | -| 4 | `$MF_FILTERLIST_FILE` is a dir | -| 5 | `jq` is not installed | -| 6 | `curl` is not installed | -| 7 | could not connect to `miniflux` | -| 8 | `xargs` is not installed | -| 9 | `sed` is not installed | -| 10 | `sort` is not installed | -| 11 | `awk` is not installed | + +| RC | Description | +| --- | ------------------------------- | +| 1 | `$MF_FILTERLIST_FILE` not found | +| 2 | `$MF_AUTH_TOKEN` not set | +| 3 | `$MF_API_URL` not set | +| 4 | `$MF_FILTERLIST_FILE` is a dir | +| 5 | `jq` is not installed | +| 6 | `curl` is not installed | +| 7 | could not connect to `miniflux` | +| 8 | `xargs` is not installed | +| 9 | `sed` is not installed | +| 10 | `sort` is not installed | +| 11 | `awk` is not installed | ## Build Container + ```shell git clone https://git.mgrote.net/mg/miniflux-filter cd miniflux-filter @@ -91,6 +97,6 @@ export MF_DOCKERHUB_USER= ./build.sh ``` - ## License + This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](./LICENSE) file for details.