{"id":29152836,"url":"https://github.com/y0k4i-1337/telesiphon","last_synced_at":"2026-04-29T04:34:48.641Z","repository":{"id":300834048,"uuid":"1007329435","full_name":"y0k4i-1337/telesiphon","owner":"y0k4i-1337","description":"TeleSiphon is a lightweight and flexible Telegram feed relay tool.","archived":false,"fork":false,"pushed_at":"2025-06-23T20:43:50.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T21:35:06.113Z","etag":null,"topics":["automation","slack","telegram","webhook"],"latest_commit_sha":null,"homepage":"","language":"Python","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/y0k4i-1337.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-23T20:31:19.000Z","updated_at":"2025-06-23T20:45:43.000Z","dependencies_parsed_at":"2025-06-23T21:35:07.630Z","dependency_job_id":"1865bbe6-e6b2-4352-834f-38038553daf1","html_url":"https://github.com/y0k4i-1337/telesiphon","commit_stats":null,"previous_names":["y0k4i-1337/telesiphon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/y0k4i-1337/telesiphon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y0k4i-1337%2Ftelesiphon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y0k4i-1337%2Ftelesiphon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y0k4i-1337%2Ftelesiphon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y0k4i-1337%2Ftelesiphon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/y0k4i-1337","download_url":"https://codeload.github.com/y0k4i-1337/telesiphon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y0k4i-1337%2Ftelesiphon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262876868,"owners_count":23378139,"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":["automation","slack","telegram","webhook"],"created_at":"2025-07-01T01:03:11.797Z","updated_at":"2026-04-29T04:34:43.623Z","avatar_url":"https://github.com/y0k4i-1337.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TeleSiphon 📡\n\n**TeleSiphon** is a lightweight and flexible Telegram feed relay tool.\n\nIt connects to specific Telegram groups, channels, or topics (including forum\ntopics), monitors new messages, and forwards them automatically to an external\nchannel via Incoming Webhook. Currently, it supports Slack as the output target.\n\n---\n\n## Features\n\n- Supports Telegram Supergroups and Topics (Forum threads)\n- Supports multiple source channels/topics\n- Slack Webhook integration\n- YAML configuration file\n- Easily extensible for future output targets (Discord, Web APIs, etc.)\n\n---\n\n## Requirements\n\n- Python 3.x\n- Telegram API credentials (API ID and API Hash from [my.telegram.org](https://my.telegram.org))\n- Slack Webhook URL\n\n---\n\n## Installation\n\n```bash\ngit clone https://github.com/y0k4i-1337/telesiphon.git\ncd telesiphon\npoetry install\n```\n\n## Configuration\n\nCopy the `config.example.yaml` file to `config.yaml` and fill in your\nTelegram API credentials and Slack Webhook URL, as well as the channels\nyou want to monitor.\n\nIn order to find the topic IDs, you can use the `enum_topics.py` script:\n\n```bash\npoetry run ./enum_topics.py --group @monitored_group\n```\n\nTake note of the topic IDs you want to monitor and add them to your `config.yaml`.\n\n## Running the Application\n\nTo run the application, use the following command:\n\n```bash\npoetry run python ./telesiphon.py -v\n```\n\nBy default, it will retrieve the messages from the current date. You can also\nspecify a limit on the number of messages to retrieve using the `--limit`\noption, in which case the application will retrieve the latest messages\nup to the specified limit. Finally, you can specify an offset id to\nretrieve messages starting from a specific message ID using the `--offset-id`.\n\nThe script will write a state file to keep track of the last processed message.\nWhen you run the script again, it will continue from where it left off, if no\n`--offset-id` is specified.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fy0k4i-1337%2Ftelesiphon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fy0k4i-1337%2Ftelesiphon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fy0k4i-1337%2Ftelesiphon/lists"}