Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


GitHub tag (latest by date) Docker Pulls Docker Stars GitHub Workflow Status (branch) Docker Image Size (latest by date)

RSS to Telegram bot

A self-hosted telegram JavaScript/TypeScript bot that dumps posts from RSS feeds to a telegram chat. This script was created because all the third party services were unreliable.

Image of help menu


For the docker image go to:


Dont forget to use the right node version. nvm use or match the version in .nvmrc

npm install
cp .env.example .env
npm run dev

Dont forget to fill the .env file

A telegram bot is needed that the script will connect to. Running the script and typing in /help will reveal the current chatId, this needs to be set also in the script

  1. Clone the script
  2. Replace your chatID and Token on the top of the script.
  3. Edit the delay. (seconds)
  4. Save and run
  5. Use the telegram commands to manage feeds

Warning! Without chatID the bot wont be able to send automated messages and will only be able to respond to messages.


send /help to the bot to get this message:

RSS to Telegram bot v2.0.0

After successfully adding a RSS link, the bot starts fetching the feed every 10 seconds. (This can be changed)

Titles are used to easily manage RSS feeds and need to contain only one word

/help shows this help message
/add title
/remove link_name removes the RSS link, multiple links can be removed with one command
/list Lists all the titles and the RSS links from the DB
/test Inbuilt command that fetches a post from Reddits RSS.

The current chatId is: 2032xxxx

Known issues

There are no known issues.


docker create \ \
  -e DELAY=60 \
  -e TOKEN=InsertToken \
  -e DEBUG=true \
  -e CHATID=InsertChatID \
  -v /path/to/host/config:/app/config \
  --restart unless-stopped \