{"id":36494924,"url":"https://github.com/0x111/telegram-rss-bot","last_synced_at":"2026-01-12T02:00:08.438Z","repository":{"id":44447514,"uuid":"139996217","full_name":"0x111/telegram-rss-bot","owner":"0x111","description":"RSS bot for telegram written in Go","archived":false,"fork":false,"pushed_at":"2021-02-10T23:14:38.000Z","size":24,"stargazers_count":41,"open_issues_count":11,"forks_count":21,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-18T23:06:41.536Z","etag":null,"topics":["go","golang","rss-feed","rss-feed-parser","telegram","telegram-bot","telegram-bots"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0x111.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-06T14:40:08.000Z","updated_at":"2024-05-27T06:02:08.000Z","dependencies_parsed_at":"2022-07-13T14:10:30.185Z","dependency_job_id":null,"html_url":"https://github.com/0x111/telegram-rss-bot","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/0x111/telegram-rss-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x111%2Ftelegram-rss-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x111%2Ftelegram-rss-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x111%2Ftelegram-rss-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x111%2Ftelegram-rss-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0x111","download_url":"https://codeload.github.com/0x111/telegram-rss-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x111%2Ftelegram-rss-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28331499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T00:36:25.062Z","status":"ssl_error","status_checked_at":"2026-01-12T00:36:15.229Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["go","golang","rss-feed","rss-feed-parser","telegram","telegram-bot","telegram-bots"],"created_at":"2026-01-12T02:00:07.097Z","updated_at":"2026-01-12T02:00:08.417Z","avatar_url":"https://github.com/0x111.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# telegram-rss-bot\n\nThe project is looking for a maintainer. Let me know in the discussions if someone is interested.\n\n## Introduction\nThis is an another telegram bot for usage with RSS feeds.\n\n## First steps\nTo use this, you first need to register a telegram bot by reading the documentation: https://core.telegram.org/bots#3-how-do-i-create-a-bot\n\nFor this bot to work, you will need a token which authorizes you to use the telegram api.\n\n## First run\nAfter you have the token, you should create a copy of the sample file and fill it out accordingly.\n\n## Configuration\n\nRename `bot-config.sample.json` to `bot-config.json`.\n\nYou can put the config file in the current folder on where the binary resides or put it in this folder if created `$HOME/.telegram-rss-bot`, the app should be able to find it here too if you want to have some fixed location for your configuration files.\n\n```json\n{\n  \"telegram_auth_key\": \"token\",\n  \"migrations\": \"v1\",\n  \"telegram_api_debug\": false,\n  \"db_path\": \"./bot.db\",\n  \"log_level\": \"info\",\n  \"feed_parse_amount\": 5,\n  \"feed_post_amount\": 2,\n  \"feed_updates_interval\": 600,\n  \"feed_posts_interval\": 400\n}\n```\n\n- telegram_auth_key: is the token which you've got from registering the bot\n- migrations: this will be used mostly in the future, to define which migration to run (this can change)\n- telegram_api_debug: if this is turned on, you will see debug messages from the telegram api on your stdout\n- db_path: this contains a path to the db file, if this does not exist, it will be created if the app will have permission to do that\n- log_level: with this, you can set the log level to display, the app is using logrus for logging, so this is accepting all the values from this url https://github.com/sirupsen/logrus#level-logging\n- feed_parse_amount: this represents the amount of how much of the feed items should be parsed from the provided feed url (e.g. if you provide a url, which has 10 items, then only the 5 latest will be saved to our database, you can alter this value if needed)\n- feed_post_amount: this represents the amount of how much of the parsed feed data should be posted to their respective channels (e.g. if you set this to 2, the bot will post every $feed_posts_interval only 2 entries, you can alter value if needed)\n- feed_updates_interval: this represents the interval at which rate the feeds saved in the database should be updated in seconds (60 = 60 seconds and so on)\n- feed_posts_interval: this represents the interval at which rate the feeds should be posted to their respective channels in seconds (60 = 60 seconds and so on)\n\n## Docker support\nYou can also run this application as a docker container.\n\n### Docker hub\n\nYou can pull the official docker image\n```bash\ndocker pull ruthless/telegram-rss-bot\ndocker run -e TELEGRAM_AUTH_KEY=\"MY-TOKEN\" ruthless/telegram-rss-bot\n```\n\n### Build from source\nExecute the following steps:\n```\ngit clone https://github.com/0x111/telegram-rss-bot\ndocker build -t telegram-rss-bot:latest .\ndocker run --name telegram-rss-bot -e TELEGRAM_AUTH_KEY=\"MY-TOKEN\" -d telegram-rss-bot:latest\n```\n\n## Important\nAdvisory: You should respect the rate limiting of the Telegram API (More info about this: https://core.telegram.org/bots/faq#my-bot-is-hitting-limits-how-do-i-avoid-this)\n\nFeel free to open a PR if you find some bugs or have improvements (I am sure there can be many of those :))\n\nIf you find bugs but you have no idea how to fix them, please open an issue with a detailed description on how to reproduce the bug.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0x111%2Ftelegram-rss-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0x111%2Ftelegram-rss-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0x111%2Ftelegram-rss-bot/lists"}