at-rss: A RSS Feed Parser for aria2c and transmission
A lightweight RSS feed parser that monitors RSS feeds and automatically downloads torrents via aria2c or transmission RPC.
Features
- Supports both aria2c and transmission RPC
- Flexible feed configuration with include/exclude filters
- Magnet link extraction and reconstruction
- Automatic cleanup of completed downloads
- Simple YAML configuration via web
Installation
- Install Go 1.20+
- Clone this repository:
git clone https://github.com/picking-gh/at-rss.git
cd at-rss
- Build the binary:
go build
- Build the webui:
cd webui
npm install
npm run build
Configuration
Create at-rss.conf in YAML format:
# Example configuration
my_feed:
downloaders:
- type: aria2c
token: "your_token"
autoCleanUp: true
feeds:
- "https://example.com/rss"
filter:
include: ["1080p", "x264"]
exclude: ["camrip", "tc"]
interval: 60 # minutes
Running
./at-rss -c /path/to/at-rss.conf
or
./at-rss -c /path/to/at-rss.conf -web-listen :8080 --web-ui-dir /path/to/webui/dist
Or run as a systemd service (see at-rss.service for example).
For more command-line options, run
./at-rss -h
Configuration Options
| Key |
Required |
Description |
| downloaders |
Yes |
Download client configurations |
| feeds |
Yes |
List of RSS feed URLs |
| filter.include |
No |
Keywords to include |
| filter.exclude |
No |
Keywords to exclude |
| interval |
No |
Polling interval in minutes (default: 10) |
| extracter |
No |
Magnet link extraction configuration |
Technical Details
- Uses gofeed for RSS parsing
- Supports Chinese text conversion (simplified/traditional)
- Implements caching to avoid duplicate downloads
License
MIT License - See LICENSE for details.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss.