Repolode
versun

versun/RSSBox

A self-hosted RSS manager that translates, summarizes, filters and merges feeds with DeepL or OpenAI-compatible models.

Open-source alternative to:Feedly

Stars
681
Forks
78
Open issues
2
Last commit
3 days ago

What is it?

RSSBox is a self-hosted RSS management tool, formerly known as RSS Translator. It processes feed items with AI or machine translation so readers can consume content in another language. Each feed can be assigned its own translation engine, and the output can be shown as a bilingual view or as a new translated RSS or JSON feed.

Beyond translation, RSSBox can summarize entries, fetch full article text, and filter items by keyword or with AI-based filtering. Multiple feeds can be merged into a single unified feed by tag, with filters applied to the combined result. It also lets you control how often each source updates and see how many tokens or characters each source has consumed.

The project is built with Python and Django. Currently supported translation engines are DeepL and any model that exposes an OpenAI-compatible API. The project is under the GPL-3.0 license and includes Docker images.

Key features

  • 01Translates titles, content, or summaries of feed items.
  • 02Shows original and translated text side by side in bilingual mode.
  • 03Publishes translated feeds as RSS or JSON.
  • 04Lets each feed use its own translation engine, such as DeepL or an OpenAI-compatible model.
  • 05Filters items by keyword or AI-based rules.
  • 06Merges multiple feeds by tag into one unified feed.

Use cases

  • Reading foreign-language news or blogs in your own language.
  • Reducing a high-volume feed to short AI-generated summaries.
  • Combining several topic feeds into one filtered stream.
  • Running a private, self-hosted feed reader with Docker.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/versun/rssbox.git
  2. 2

    Enter the project directory

    cd rssbox
  3. 3

    Install dependencies and start the dev server

    uv run dev

Things to know

  • Documentation and most of the README are in Chinese; an English README is linked separately.
  • Translation requires a paid DeepL account or an OpenAI-compatible model API key.

In collections

Topics

FAQ

What is RSSBox?
A self-hosted RSS manager that translates, summarizes, filters and merges feeds with DeepL or OpenAI-compatible models. RSSBox is a self-hosted RSS management tool, formerly known as RSS Translator. It processes feed items with AI or machine translation so readers can consume content in another language. Each feed can be assigned its own translation engine, and the output can be shown as a bilingual view or as a new translated RSS or JSON feed.
Is RSSBox free to use? What license does it have?
RSSBox is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is RSSBox still maintained?
Actively maintained. The last commit to RSSBox was on Nov 5, 2026.
What can I use RSSBox for?
Reading foreign-language news or blogs in your own language. Reducing a high-volume feed to short AI-generated summaries. Combining several topic feeds into one filtered stream. Running a private, self-hosted feed reader with Docker.
How do I install RSSBox?
Clone the repository: git clone https://github.com/versun/rssbox.git Enter the project directory: cd rssbox Install dependencies and start the dev server: uv run dev
Where can I get RSSBox?
The source code and installation instructions are on GitHub: https://github.com/versun/RSSBox

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects