{"id":15107886,"url":"https://github.com/unkwusr/vk-tg-suckling-user-bot","last_synced_at":"2026-02-17T19:33:18.107Z","repository":{"id":209347846,"uuid":"720317944","full_name":"UnkwUsr/vk-tg-suckling-user-bot","owner":"UnkwUsr","description":"Bridge messages from vk.com to telegram (one-way only)","archived":false,"fork":false,"pushed_at":"2025-03-31T22:19:11.000Z","size":49,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-31T23:22:22.424Z","etag":null,"topics":["bot","bridge","telegram","tg","user-bot","vk","vkontakte"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UnkwUsr.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}},"created_at":"2023-11-18T05:24:55.000Z","updated_at":"2025-03-31T22:19:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"fe5cdab3-46c6-43d7-a7e3-b1a01d14e070","html_url":"https://github.com/UnkwUsr/vk-tg-suckling-user-bot","commit_stats":{"total_commits":34,"total_committers":1,"mean_commits":34.0,"dds":0.0,"last_synced_commit":"17a85f0cc451c48564440e1eb0c99ded767bf96c"},"previous_names":["unkwusr/vk-tg-suckling-user-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fvk-tg-suckling-user-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fvk-tg-suckling-user-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fvk-tg-suckling-user-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fvk-tg-suckling-user-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UnkwUsr","download_url":"https://codeload.github.com/UnkwUsr/vk-tg-suckling-user-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247353680,"owners_count":20925325,"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","bridge","telegram","tg","user-bot","vk","vkontakte"],"created_at":"2024-09-25T21:42:33.052Z","updated_at":"2026-02-17T19:33:13.073Z","avatar_url":"https://github.com/UnkwUsr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vk-tg-suckling-user-bot\n\nThis is one-way bridge for chat messages from vkontakte to telegram (hence\n\"suckling\", it sucks (messages) from vk, and only this way).\n\nYou can make multiple different chat bridges, selecting from which vk chat to\ntake messages and to which telegram chat bridge them.\n\nThis is user bot, meaning that it uses user auth token. I don't know if it\nworks with group tokens because I don't have one, but probably it should works\ntoo.\n\n## Supported attachments\n\n* [x] reply messages\n* [x] forwarded messages\n* [x] images\n* [x] voice messages\n* [x] documents (aka files)\n* [x] stickers\n* [x] graffiti\n* [x] links\n* [x] wall posts\n* [x] comments to wall posts\n* [x] video (reuploads video files to telegram (by default limited to 3 minutes\n  video duration))\n\nnot planned:\n\n* music (user token have not enough permissions)\n* stories (user token have not enough permissions)\n\n## Running\n\nPreparation step: rename `config.py.example` to `config.py` and edit it\naccording to the template.\n\n### docker compose\n\n```\ndocker-compose up --build\n```\n\n### Manual\n\nInstall dependencies:\n\n```\npip install -r requirements.txt\n```\n\nRun bot:\n\n```\npython main.py\n```\n\nOr if you running it on server, you may want to use script that write logs to\nfile and automatically restarts if bot crashes (but be careful: it will still\ninfinitely restarting if you have syntax errors in config file):\n\n```\n./run_bot_vk_tg.sh\n```\n\n## License notice\n\n```\nCopyright (C) 2023 UnkwUsr\n\nThis program is free software; you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation; either version 2 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along\nwith this program; if not, write to the Free Software Foundation, Inc.,\n51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funkwusr%2Fvk-tg-suckling-user-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funkwusr%2Fvk-tg-suckling-user-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funkwusr%2Fvk-tg-suckling-user-bot/lists"}