Skip to content

BiswajyotiRay/rss-chan

 
 

Repository files navigation

A telegram RSS feed reader bot, made in python using feedparser.


About

A self-hosted telegram bot that dumps posts from a RSS feed to a telegram chat.

This project is inspired by BoKKeR's telegram bot and ayrat555's el_monitorro bot written in Rust.

Note: The previous version was a complete refactor of BoKKeR's code, which also addresses a couple of issues in his repo with many bug fixes and features of my own. They've been integrated with the current version. Head over to the changelog section for more.

Deploy

Instructions to deploy to Heroku or self-host resides in the wiki.

Config

Make a config.env on gist and add this value

BOT_TOKEN = "" # tg bok token ofc
OWNER_ID =  # who manage all things
CHAT_ID = "" # channal id
DELAY = 600 # The delay between each feed request. (set 600)
CUSTOM_MESSAGES = "" # To display a custom message at the top of every new feed.
DATABASE_URL = "" # heroku-postgresql database url

Usage

The bot uses a TITLE <-> URL mechanism so that the user doesn't have to mess with the feed URL every time, instead use a TITLE to perform a task.

Commands:
/help: To get the help message
/list: List your subscriptions
/get TITLE 10: Force fetch last n item(s)
/sub TITLE https://www.rss-url.com/feed: Subscribe to a RSS feed
/unsub TITLE: Removes the RSS subscription corresponding to it's title
/unsuball: Removes all subscriptions
/template TITLE TEMPLATE: Set a template to a specific RSS feed

Credits

Projects used in the making:

Others:

About

A telegram RSS feed reader bot, made in python using feedparser.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 94.7%
  • Shell 3.0%
  • Dockerfile 2.2%
  • Procfile 0.1%