RSSingle/README.md
2023-10-26 14:53:27 +02:00

83 lines
1.6 KiB
Markdown

# RSSingle
Generates an RSS file from the list of other feeds (RSS/Atom/JSON). Very handy when you want to centralise the list of your feeds in one place and all your devices feed from the same place.
<p align="center">
<img src="rssingle.png" width="200" alt="RRSingle">
</p>
## Run
1. Download the binary.
**Linux**
``` shell
wget https://github.com/tanrax/RSSingle/releases/download/v1.0.0/rssingle
```
**Windows**
``` shell
wget https://github.com/tanrax/RSSingle/releases/download/v1.0.0/rssingle.exe
```
2. Gives execution permissions.
``` shell
chmod +x rssingle
```
3. In the same directory as the binary, you can create a local `config.yml` file in this format:
``` yaml
title: My RSS Feed
description: My customised RSS feed with technology news
url: https://www.example.com
output: rss.xml
max_entries: 5 # Delete this line to get all
feeds:
- https://programadorwebvalencia.com/feed/
- https://republicaweb.es/feed/
```
If not, you can download the example in the repository.
``` shell
curl -o config.yml https://raw.githubusercontent.com/tanrax/RSSingle/master/config.yml
```
4. Run the binary.
``` shell
./rssingle
```
A file called `rss.xml` will be created.
## Development
Activate Debug messages by console.
```
export SR_LOG_LEVEl=DEBUG
```
### Compiling
```shell
pyinstaller --onefile rssingle.py
```
Old versions
```shell
docker run --rm --volume $PWD:/app python:3.8-buster /bin/bash -c "cd /app; pip3 install -r requirements.txt; pyinstaller --onefile rssingle.py"
```
You will find the binary in `dist`.
## Thanks
@shymega for his original project [singlerss](https://github.com/shymega/singlerss).