{"id":13827552,"url":"https://github.com/alcortazzo/vktgbot","last_synced_at":"2025-09-29T03:30:32.962Z","repository":{"id":37951573,"uuid":"255265445","full_name":"alcortazzo/vktgbot","owner":"alcortazzo","description":"🇺🇦 Telegram Bot for reposting from VKontakte to Telegram channel","archived":true,"fork":false,"pushed_at":"2023-11-19T11:51:02.000Z","size":648,"stargazers_count":129,"open_issues_count":5,"forks_count":37,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-10-09T18:21:28.937Z","etag":null,"topics":["bot","parser","pytelegrambotapi","python","python3","telegram","telegram-bot","vk-api","vkontakte","vkontakte-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alcortazzo.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}},"created_at":"2020-04-13T07:57:36.000Z","updated_at":"2024-09-24T17:01:53.000Z","dependencies_parsed_at":"2023-11-19T12:31:03.483Z","dependency_job_id":"a76c17a5-5615-4dc1-937f-9b1d671bfe0b","html_url":"https://github.com/alcortazzo/vktgbot","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alcortazzo%2Fvktgbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alcortazzo%2Fvktgbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alcortazzo%2Fvktgbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alcortazzo%2Fvktgbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alcortazzo","download_url":"https://codeload.github.com/alcortazzo/vktgbot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234583683,"owners_count":18856280,"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","parser","pytelegrambotapi","python","python3","telegram","telegram-bot","vk-api","vkontakte","vkontakte-api"],"created_at":"2024-08-04T09:02:01.430Z","updated_at":"2025-09-29T03:30:27.554Z","avatar_url":"https://github.com/alcortazzo.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003evktgbot\u003c/h1\u003e\n\u003cp align=center\u003e\n    \u003ca target=\"_blank\" href=\"https://www.python.org/downloads/\" title=\"Python Version\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-%3E=_3.8-purple.svg\"\u003e\u003c/a\u003e\n    \u003ca target=\"_blank\" href=\"https://github.com/alcortazzo/vktgbot/releases\"\u003e\u003cimg alt=\"docker image\" src=\"https://img.shields.io/github/v/release/alcortazzo/vktgbot?include_prereleases\"\u003e\u003c/a\u003e\n    \u003ca target=\"_blank\" href=\"LICENSE\" title=\"License: GPL-3.0\"\u003e\u003cimg src=\"https://img.shields.io/github/license/alcortazzo/vktgbot.svg?color=red\"\u003e\u003c/a\u003e\n\u003c/p\u003e \n\n\u003cp align=\"center\"\u003e\u003cb\u003eTelegram bot for automatic forwarding posts from VK to Telegram.\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://youtu.be/59_-yB5WjnI\"\u003e\n        \u003cimg src=\"https://github.com/alcortazzo/vktgbot/blob/master/images/code.png\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n## About\n\nPython script to automatically repost from VK community pages to Telegram channels or chats. Once the script is set up and running, it will check for new posts in VK every *N* seconds using VK API and, if there are any, parse and send them to Telegram.\n\n## How to use the script\n\nYou can manually run the script with Python or Docker and leave it running in the background. Or you can set the script to run automatically on the remote server with tools like crontab, systemd, etc. Or you can configure the script to run at one time if you set `VAR_SINGLE_START = True` in `.env` file.\n\n## Installation\n```shell\n# clone the repository\n$ git clone https://github.com/alcortazzo/vktgbot.git\n\n# if you want to clone specific version (for example v2.6)\n$ git clone -b v2.6 https://github.com/alcortazzo/vktgbot.git\n\n# change the working directory to vktgbot\n$ cd vktgbot\n```\n*Note that in version 3.0 the script has been rewritten from the [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI) library to the [aiogram](https://github.com/aiogram/aiogram) library. So if you want to install an older version of the script working with the pyTelegramBotAPI library, install version 2.6 using the method above. You can find instructions on how to run an older version of the script [here](https://github.com/alcortazzo/vktgbot/tree/v2.6).*\n\n## Configuring\n**Open `.env` configuration file with text editor and set the following variables:**\n```ini\nVAR_TG_CHANNEL = @aaaa\nVAR_TG_BOT_TOKEN = 1234567890:AAA-AaA1aaa1AAaaAa1a1AAAAA-a1aa1-Aa\nVAR_VK_TOKEN = 00a0a0ab00f0a0ab00f0a6ab0c00000b0f000f000f0a0ab0a00b000000dd00000000de0\nVAR_VK_DOMAIN = bbbb\n```\n* `VAR_TG_CHANNEL` is link or ID of Telegram channel. **You must add bot to this channel as an administrator!**\n* `VAR_TG_BOT_TOKEN` is token for your Telegram bot. You can get it here: [BotFather](https://t.me/BotFather).\n* `VAR_VK_TOKEN` is personal token for your VK profile. You can get it here: [HowToGet](https://github.com/alcortazzo/vktgbot/wiki/How-to-get-personal-access-token).\n* `VAR_VK_DOMAIN` is part of the link (after vk.com/) to the VK channel. For example, if link is `vk.com/durov`, you should set `VAR_VK_DOMAIN = durov`.\n\n**Open the file \"last_id.txt\" and write in it the ID of the last message (not the pinned one!):**\n* For example, if the link to post is `https://vk.com/wall-22822305_1070803`, then the id of that post will be `1070803`.\n* [Example photo](https://i.imgur.com/eWpso0C.png)\n\n## Running\n### Using Python\n```shell\n# install requirements\n$ python3 -m pip install -r requirements.txt\n\n# run script\n$ python3 vktgbot\n```\n### Using Docker\n```shell\n# change the working directory to docker\n$ cd docker\n\n# build and run docker\n$ docker-compose up --build\n```\n## License\nGPLv3\u003cbr/\u003e\nOriginal Creator - [alcortazzo](https://github.com/alcortazzo)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falcortazzo%2Fvktgbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falcortazzo%2Fvktgbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falcortazzo%2Fvktgbot/lists"}