FeedForger 🔨⚡

Forge multiple RSS/Atom feeds into organized JSON groups. Runs on GitHub Actions with scheduled updates and releases.

Quick Start

1. Fork this repo
2. Edit recipes/recipes.toml with your feeds (supports .toml and .opml)
3. Enable GitHub Actions — uncomment the schedule trigger in .github/workflows/main.yml
4. Feeds are published as GitHub Releases

Local Usage

uv sync --all-extras
uv run feedforger build          # build feeds from recipes/
uv run feedforger build --help   # see all options
uv run feedforger cleanup        # clean old cache entries

Recipe Format

[recipes.MyFeeds]
urls = [
    "https://example.com/feed.xml",
    "https://example.com/rss",
]
# filters = [{ title = "pattern to exclude", invert = true }]
# fulfill = true  # fetch full article content

Also supports OPML files — just drop .opml files into the recipes/ directory.