at-rss

command module
v0.0.0-...-655923b Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 13, 2026 License: MIT Imports: 28 Imported by: 0

README

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

  1. Install Go 1.20+
  2. Clone this repository:
    git clone https://github.com/picking-gh/at-rss.git
    cd at-rss
    
  3. Build the binary:
    go build
    
  4. 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.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL