aigoncharov/telegram-to-rss repository overview

⁠telegram-to-rss

Generate an RSS feed from your Telegram chats. You digital minimalism friend.
Source code: https://github.com/aigoncharov/telegram-to-rss⁠

⁠How to get the most of it

1. Create a separate Telegram account to subscribe to various channels available only as Telegram feeds (yep, they exist!)
2. Convert all of them to RSS feeds using this app
3. Be in power of your information consumption with a single place to get it - your RSS reader!

⁠Quick start

1. Get api_id an api_hash at https://my.telegram.org⁠

2. Create a docker compose file and replace the environment variables (see Configuration⁠ for details)

   services:
   telegram-to-rss:
      image: aigoncharov/telegram-to-rss:latest
      container_name: telegram-to-rss
      restart: always
      environment:
         - TG_API_ID=REPLACE_ME
         - TG_API_HASH=REPLACE_ME
         - TG_PASSWORD=REPLACE_ME
         - BASE_URL=REPLACE_ME
      ports:
         - 3042:3042
      volumes:
         - telegram-to-rss-data:/data
   
   volumes:
   telegram-to-rss-data: null
   
   networks: {}
   

   Copy

3. Run docker compose up

4. Go to http://127.0.0.1:3042

5. Scan the QR code with your Telegram app

   1. If there is an AUTH_ERROR, restart the docker compose stack

6. Give it a few seconds to log in

7. Get redirected to a page with a list of all your chats available as RSS feeds.

   1. If the list is incomplete, give it a few minutes on the first start to generate the RSS feeds.
   2. Subsequent updates should be much faster!

⁠Configuration

Available environment variables (* marks required ones):

• * TG_API_ID - api_id from https://my.telegram.org⁠
• * TG_API_HASH - api_hash from https://my.telegram.org⁠
• * BASE_URL - address of your server that hosts this app, used in RSS feeds to correctly set image addresses
• TG_PASSWORD - your telegram password, required if 2fa is enabled on the account
• LOGLEVEL - log level for the app (supported values⁠). Default: INFO
• FEED_SIZE - size of the RSS feed. When your RSS feed grows larger than the limit, older entries are going to be discarded. Default: 200.
• INITIAL_FEED_SIZE - number of messages we fetch for any new feed on the first run. Default value: 50.
• UPDATE_INTERVAL - how often the app should fetch new messages from Telegram and regenerate RSS feeds (in seconds). Default: 3600.