{"id":13989328,"url":"https://github.com/cbrgm/telegram-robot-rss","last_synced_at":"2025-07-22T10:32:02.716Z","repository":{"id":48804734,"uuid":"108856202","full_name":"cbrgm/telegram-robot-rss","owner":"cbrgm","description":"A clean and easy to use RSS Newsfeed Bot for fabulous Telegram Messenger App! :robot: :envelope: :heart:","archived":true,"fork":false,"pushed_at":"2021-07-11T08:18:24.000Z","size":6144,"stargazers_count":192,"open_issues_count":13,"forks_count":92,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-11-28T21:39:05.334Z","etag":null,"topics":["bot","messenger","python","rss","rss-feed","rss-reader","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cbrgm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-30T13:40:42.000Z","updated_at":"2024-08-31T12:31:24.000Z","dependencies_parsed_at":"2022-07-26T15:45:33.388Z","dependency_job_id":null,"html_url":"https://github.com/cbrgm/telegram-robot-rss","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Ftelegram-robot-rss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Ftelegram-robot-rss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Ftelegram-robot-rss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Ftelegram-robot-rss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cbrgm","download_url":"https://codeload.github.com/cbrgm/telegram-robot-rss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227079223,"owners_count":17727982,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","messenger","python","rss","rss-feed","rss-reader","telegram-bot"],"created_at":"2024-08-09T13:01:36.493Z","updated_at":"2024-11-29T08:31:00.203Z","avatar_url":"https://github.com/cbrgm.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# RobotRSS - A Telegram RSS Bot\n\n![RobotRss Logo](logo/text/robotrss_logo_text_512.png)\n\n![Github python](https://img.shields.io/badge/latest_release-1.0.2-lightgrey.svg)\n![Github python](https://img.shields.io/badge/python-2.7-blue.svg)\n[![GitHubissues](https://img.shields.io/github/issues/cbrgm/telegram-robot-rss.svg)](https://github.com/cbrgm/telegram-robot-rss/issues)\n[![GitHub license](https://img.shields.io/badge/telegram-%40RobotRssBot-blue.svg)](https://telegram.me/RobotRssBot)\n\n## Description\n\nRobotRSS is an RSS Bot for the Telegram Messenger. Subscribe to different news channels and stay up-to-date. Receive instant messages in your Messenger app when websites are updated, e. g. on news pages, blogs or audio/video logs.\n\nThe latest stable release and release notes can be found [here][ba8097ee].\n\n  [ba8097ee]: https://github.com/cbrgm/telegram-robot-rss/releases/latest \"releases\"\n\n### Deploy to Heroku:\n\u003cp align=\"left\"\u003e\u003ca href=\"https://heroku.com/deploy\"\u003e \u003cimg src=\"https://www.herokucdn.com/deploy/button.svg\" alt=\"Deploy to Heroku\" /\u003e\u003c/a\u003e\u003c/p\u003e\n\n### Usage\n\nRobotRSS has an easy-to-use user interface to get started. Write the **official [@RobotRssBot][2f7e3ad7]** via telegram. Use the following commands to manage your subscriptions:\n\n[2f7e3ad7]: https://telegram.me/RobotRssBot \"RobotRSS\"\n\n**Controls**  \n`/start` - Activates the bot. If you have subscribed to RSS feeds, you will receive news from now on  \n`/stop` - Deactivates the bot. You won't receive any messages from the bot until you activate the bot again using the start comand\n\n**RSS Management**  \n`/add \u003curl\u003e \u003centryname\u003e` - Adds a new subscription to your list.  \n`/remove \u003centryname\u003e` - Removes an exisiting subscription from your list.  \n`/get \u003centryname\u003e [optional: \u003ccount 1-10\u003e]` - Manually parses your subscription, sending you the last \u003ccount\u003e elements.  \n`/list` - Shows all your subscriptions as a list.\n\n**Other**  \n`/about` - Shows some information about RobotRSS Bot  \n`/help` - Shows the help menue\n\n## Feature Request and Contributing\n\nYou have suggestions for improvements or features you miss? You are welcome to express all your wishes here. Just create a new [Issue][e872f832] and it will be taken care of quickly!\n\n[e872f832]: https://github.com/cbrgm/telegram-robot-rss/issues \"RobotRSS Issues\"\n\nIf you are a developer yourself, you can also contribute code! Further information will follow shortly.\n\n## Installation\n\nThe source code of RobotRSS is Open Source and openly accessible and editable. If you would like to use your own bot as newsfeed reader, you will find everything you need to install it here. It is recommended to run the bot in a docker container. You can find the latest, stable Docker Image on Dockerhub. If you make changes to the source code, you can easily create a new image of your version using the dockerfile located in the project folder.\n\n### Create a credentials file\n\nFirst, you must tell RobotRSS which bot the service is allowed to communicate with. Create a new telegram bot or use an existing one. All you need is the Bot's `Token` from Telegram. You can receive one from Telegrams [Botfather][db6676cf].\n\nEdit the `credentials.json` file located at `/resources/credentials.json`.\n\n```json\n{\n  \"telegram_token\": \"INSERT TOKEN\",\n  \"update_interval\": 300\n}\n```\n  [db6676cf]: tg://resolve?domain=BotFather \"Botfather\"\n\n### Install Dependencies using pip\n\nYou can easily install all needed Dependencies using `pip`. Navigate into the project directory and run `pip install -r requirements.txt`. If you prefer installing all Dependencies manually you can find a detailed list of all needed packages at the \"Dependencies\" Section at the bottom of the page.\n\n### Create a Docker Image\n\nYou can easily run RobotRSS inside a Docker Container. The Dockerfile can be found in the project directory. Run `docker build --tag \"RobotRSS:latest\" .` to create a new Docker Image based on the current code.\n\nYou can also pull the latest image from Dockerhub using `docker pull cynthek/RobotRSS:latest`.\n\nTo start your docker container use the following commands, passing `BOT_TOKEN` and optional `UPDATE_INTERVAL` environment variable to the container:\n\n```bash\ndocker run -itd --name \"your-container-name\" -e BOT_TOKEN=\"Enter your token\" robotrss:latest\n# or use\ndocker run -itd --name \"your-container-name\" -e BOT_TOKEN=\"Enter your token\" -e UPDATE_INTERVAL=\u003cNumber in Minutes\u003e robotrss:latest\n```\n\n`UPDATE_INTERVAL` is set to 300 per default, updating feeds of subscribers every 5 minutes (300 sec).\n\n## Python Version\n\nRobotRSS has been successfully tested with Python 2.7 .\n\n## Dependencies\n\nAll Dependencies can be found in the `requirements.txt` file in the project directory.\n\n## Motivation\n\nThis script was originally developed by [Christian Bargmann][b9824663] for practice purposes with Python.\n\n  [b9824663]: http://cbrgm.de \"blog\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbrgm%2Ftelegram-robot-rss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcbrgm%2Ftelegram-robot-rss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbrgm%2Ftelegram-robot-rss/lists"}