# transmission-rss
A simple binary that reads a config file with a list of rss torrent items and adds them
to transmission.
- [X] Telegram notification
- [X] Concurrent rss fetch and processing
- [X] Helm chart to deploy in a Kubernetes cluster
- [X] Docker container to use directly or with docker-compose
```
$ transmission-rss
USAGE:
transmission-rss --config <CONFIG>
OPTIONS:
-c, --config <CONFIG> Path to the config file
-h, --help Print help information
-V, --version Print version information
```
### Getting started
If you have cargo installed it's possible to install the binary by running:
```
$ cargo install transmission-rss
$ transmission-rss -c config.toml
----------------------------
==> Processing [RSS New Linux Distros]
10 items processed
```
### Config file
Example of `config.toml`:
```toml
[persistence]
path = "/path/to/db/folder"
[transmission]
url = "http://myserver/transmission/rpc"
username = "myusername"
password = "mypassword"
[notification.telegram]
bot_token = 123123:your_token
chat_id = 123123
[[rss_list]]
title = "My List"
url = "https://someweb.site/rss.xml"
filters = ["1080p"]
download_dir = "/downloads/my_folder"
```
The password and telegram bot token can optionally be loaded from separate files by specifying `password_file`/`bot_token_file` instead.
### Docker
It's also possible to run the docker container directly or using `docker-compose.yml`.
```
$ docker run -v ./persistence:/persistence ghcr.io/herlon214/transmission-rss:v0.2.2 -- -c /persistence/config.toml
```
### Kubernetes
You can also use the helm chart in the `helm/` for deploying in your kubernetes cluster.
Create your config map and update the `configMapName` when deploying the helm chart.
ConfigMap example:
```yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: transmission-rss-cm
data:
config.toml: |
[persistence]
path = "/db"
[transmission]
url = "http://yourserver/transmission/rpc"
username = "username"
password = "password"
[notification.telegram]
bot_token = "123:token"
chat_id = 123123
[[rss_list]]
title = "My Item"
url = "https://rss.link/here"
filters = ["1080p"]
download_dir = "/path/to/store"
```