{"id":44739845,"url":"https://github.com/prsai/irgramd","last_synced_at":"2026-02-15T20:34:27.073Z","repository":{"id":90683208,"uuid":"308151633","full_name":"prsai/irgramd","owner":"prsai","description":"IRC-Telegram Gateway, use Telegram with your IRC client","archived":false,"fork":false,"pushed_at":"2025-04-13T23:03:10.000Z","size":581,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-14T00:32:24.591Z","etag":null,"topics":["gateway","irc","irc-server","ircd","python3","telegram","telegram-client","telethon"],"latest_commit_sha":null,"homepage":"https://src.presi.org/darcs/irgramd","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"pbui/irtelegramd","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prsai.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":"2020-10-28T22:03:29.000Z","updated_at":"2025-04-13T23:03:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"cd45ed4a-1283-4c67-9de2-3bd84020c7db","html_url":"https://github.com/prsai/irgramd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/prsai/irgramd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prsai%2Firgramd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prsai%2Firgramd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prsai%2Firgramd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prsai%2Firgramd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prsai","download_url":"https://codeload.github.com/prsai/irgramd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prsai%2Firgramd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29488632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["gateway","irc","irc-server","ircd","python3","telegram","telegram-client","telethon"],"created_at":"2026-02-15T20:34:26.537Z","updated_at":"2026-02-15T20:34:27.068Z","avatar_url":"https://github.com/prsai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# irgramd - IRC \u003c-\u003e Telegram Gateway\n\nirgramd is a gateway that allows connecting from an [IRC] client to\n[Telegram] as a regular user (not bot).\n\nirgramd is written in [python] (version 3), it acts as an IRC server\nwhere an IRC client can connect and on the other side it's a Telegram client\nusing the [Telethon] library.\n\n**[irgramd primary repository] is in [darcs] version control system, github\nis used as [project management and secondary repository]**\n\n**irgramd was forked from [pbui/irtelegramd], was heavily modified and\ncurrently is a project on its own**\n\n**irgramd is under active development, though usable, several\nplanned features are not implemented yet**\n\n## How it works\n\nConfigure your IRC client to connect to irgramd (running on the same host or\non a remote host) then you will see in your IRC client the Telegram groups\nas IRC channels and Telegram users as IRC users, if you send a message to a\nuser or channel in IRC it will go to the corresponding user or group in\nTelegram, and the same from Telegram to IRC.\n\nThe users on Telegram using the official or other clients will see you with\nyour regular Telegram user account and will be indistinguishable for them\nwhether you are using irgramd or another Telegram client.\n\nSeveral IRC clients can connect to irgramd but they will see the same\nTelegram account, this allows connecting to the same Telegram account from\ndifferent IRC clients on different locations or devices, so one irgramd\ninstance only connects to one Telegram account, if you want to connect to\nseveral Telegram accounts you will need to run several irgramd instances. If\nall IRC clients are disconnected, irgramd will remain connected to Telegram.\n\nirgramd can also be seen as a kind of bouncer ([BNC]), with the difference\nthat instead of talking IRC protocol on the client side, it talks Telegram\nprotocol (MTProto), and can hide the IP and location of the IRC client (if\nexecuted in a different host).\n\n## Features\n\n- Channels, groups and private chats\n- Users and channels mapped in IRC\n- Messages (receive, send)\n- Media in messages (receive, download, upload)\n- Replies (receive, send)\n- Forwards (receive, send)\n- Deletions (receive, do)\n- Editions (receive, do)\n- Reactions (receive, send, remove)\n- Polls (receive, show)\n- Actions [pin message, channel photo] (receive)\n- Dialogs management\n- History\n- Authentication and TLS for IRC\n- Multiple connections from IRC\n\n## Requirements\n\n- [python] (\u003e= v3.9)\n- [telethon] (tested with v1.28.5)\n- [tornado] (tested with v6.1.0)\n- [aioconsole] (tested with v0.6.1)\n- [pyPAM] (optional, tested with v0.4.2-13.4 from deb, [legacy web](https://web.archive.org/web/20110316070059/http://www.pangalactic.org/PyPAM/))\n\n## Instalation\n\n### From darcs\n\n    darcs clone https://src.presi.org/repos/darcs/irgramd\n    chmod +x irgramd/irgramd\n\n### From git\n\n    git clone https://github.com/prsai/irgramd.git\n    chmod +x irgramd/irgramd\n\n## Configuration\n\nFrom irgramd directory `./irgramd --help` will show all configuration\noptions available, these options can be used directy in the command line or\nin a file.\n\nWhen used in command line the separator is `-` (dash) with two leading\ndashes, example: `--api-hash`.\n\nWhen used in a file the separator is `_` (underscore) without two leading\ndashes nor underscores, example: `api_hash`. The syntax of this file is just\nPython so strings are surrounded by quotes (`'`) and lists by brackets (`[]`).\n\nA sample of the configuration file is provided, copy it to the default\nconfiguration location:\n\n    mkdir -p  ~/.config/irgramd\n    cp irgramd/irgramdrc.sample ~/.config/irgramd/irgramdrc\n\nAnd modified it with your API IDs and preferences.\n\n## Usage\n\nFrom irgramd directory, in foreground:\n\n    ./irgramd\n\nIn background (with logs):\n\n    ./irgramd --log-file=irgramd.log \u0026\n\n## Notes\n\nPAM authentication: it allows to authenticate IRC users from the system in\nUnix/Linux. The user that executes irgramd must have permissions to use PAM\n(e.g. in Linux be in the shadow group or equivalent). The dependency is\ntotally optional, if not used, the module pyPAM is not needed.\n\n## Inspired by\n\n- [telegramircd]\n- [ibotg]\n- [bitlbee]\n\n## License\n\nCopyright (c) 2019 Peter Bui \u003cpbui@bx612.space\u003e  \nCopyright (c) 2020-2024 E. Bosch \u003cpresidev@AT@gmail.com\u003e\n\nUse of this source code is governed by a MIT style license that\ncan be found in the LICENSE file included in this project.\n\n[IRC]: https://en.wikipedia.org/wiki/Internet_Relay_Chat\n[Telegram]: https://telegram.org/\n[python]: https://www.python.org/\n[Telethon]: https://github.com/LonamiWebs/Telethon\n[irgramd primary repository]: https://src.presi.org/darcs/irgramd\n[darcs]: http://darcs.net\n[project management and secondary repository]: https://github.com/prsai/irgramd\n[pbui/irtelegramd]: https://github.com/pbui/irtelegramd\n[python]: https://www.python.org\n[tornado]: https://www.tornadoweb.org\n[aioconsole]: https://github.com/vxgmichel/aioconsole\n[pyPAM]: https://packages.debian.org/bullseye/python3-pam\n[BNC]: https://en.wikipedia.org/wiki/BNC_(software)\n[telegramircd]: https://github.com/prsai/telegramircd\n[ibotg]: https://github.com/prsai/ibotg\n[bitlbee]: https://www.bitlbee.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprsai%2Firgramd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprsai%2Firgramd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprsai%2Firgramd/lists"}