Skip to content
jacopomoioliPublic

About

A Telegram RSS feed reader that just makes sense

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

FeedBuddy

Telegram-based RSS reader that just makes sense.

  • polls RSS feeds
  • sends new posts to Telegram, with the full article as a readable PDF attachment (or audio for YouTube feeds)
  • summarizes each article with an LLM (through openrouter), and gives them a relevance score based on your interests
  • save posts for later with a button in Telegram (pins the message in the chat)
  • manage feeds from Telegram

Demo

Incoming Post Post Saved for Later
Incoming Post Post Saved for Later
Loaded Feed Listing Help Command
Loaded Feed Listing Help Command

Getting Started

Copy .env.example:

cp .env.example .env

Edit it and set the right values. TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are required. Then, run feedbuddy with Docker (recommended):

touch feedbuddy.db feedbuddy.log   # ensure these exist as files before mounting
docker compose up -d
docker compose logs -f             # tail logs

Or directly with Python:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 feedbuddy.py

Telegram Commands

Command Description
/help List available commands
/listfeeds List all registered feeds
/addfeed label | <url> Add a feed with an optional label. YouTube channel URLs (@handle, /channel/...) are resolved automatically
/delfeed <url> Remove a feed
/exportfeeds Download the current feed list as feeds.txt
/listsaved List all posts saved for later
/addgoated [title | ] <url> Manually add a URL to the Goated list
/listgoated List goated posts
/stats Reading stats: totals, read rate, top feeds
/getprompt Show the current LLM summarization instruction
/setprompt <text> Edit the LLM summarization instruction
/setinterests <text> Set your interest profile for relevance scoring
/getinterests Show your interest profile and silence threshold
/setthreshold <1-10> Set the score below which posts are delivered silently
/getlog Download the bot log file
/testfeed <url> Fetch and preview the latest post of a feed

Each post has three inline buttons: "Mark as Read", "Save for later" (which pins the message), and "Add to Goated".

Why

There are a lot of RSS solutions out there. I tried some but none felt right. I also wanted a way to save interesting articles somewhere without losing them, inspired by some Cal Newport videos.

Most of the code was written with Claude Code. I used this project to test what coding agents can actually do.

About

A Telegram RSS feed reader that just makes sense

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages