{"id":15107965,"url":"https://github.com/kylmakalle/tgvkbot","last_synced_at":"2025-07-30T03:42:27.288Z","repository":{"id":22012475,"uuid":"94715199","full_name":"Kylmakalle/tgvkbot","owner":"Kylmakalle","description":"Общайтесь в VK через Telegram бота","archived":false,"fork":false,"pushed_at":"2024-10-31T22:39:35.000Z","size":2435,"stargazers_count":75,"open_issues_count":6,"forks_count":31,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-19T01:09:49.941Z","etag":null,"topics":["docker","telegram","telegram-vk","vk","vk-telegram","vkontakte"],"latest_commit_sha":null,"homepage":"https://akentev.com/tgvkbot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kylmakalle.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":"2017-06-18T21:55:35.000Z","updated_at":"2025-04-20T20:57:54.000Z","dependencies_parsed_at":"2024-03-15T10:24:13.960Z","dependency_job_id":"89877ed0-6de1-43c8-903e-52f25d8d8a0f","html_url":"https://github.com/Kylmakalle/tgvkbot","commit_stats":{"total_commits":85,"total_committers":5,"mean_commits":17.0,"dds":"0.15294117647058825","last_synced_commit":"c99ad7fadba04c32a73252c71a17c3f6a8095475"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kylmakalle/tgvkbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kylmakalle%2Ftgvkbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kylmakalle%2Ftgvkbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kylmakalle%2Ftgvkbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kylmakalle%2Ftgvkbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kylmakalle","download_url":"https://codeload.github.com/Kylmakalle/tgvkbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kylmakalle%2Ftgvkbot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267804105,"owners_count":24146537,"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","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["docker","telegram","telegram-vk","vk","vk-telegram","vkontakte"],"created_at":"2024-09-25T21:43:29.778Z","updated_at":"2025-07-30T03:42:27.259Z","avatar_url":"https://github.com/Kylmakalle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tgvkbot\nОбщайтесь в VK через Telegram бота.\n\n- Бот от разработчика - [@tgvkbot](https://t.me/tgvkbot)\n\n- Канал - [@tg_vk](https://t.me/tg_vk)\n\n- Чат - https://t.me/joinchat/BZq6jwxeTh04qBzilM5x3g\n\n\n# Простая Установка (Ubuntu)\n```bash\ngit clone https://github.com/Kylmakalle/tgvkbot\ncd tgvkbot\n./install.sh\n\nТокен Telegram бота: 123456789:AAABBBCCCDDDEEEFFFGGGHHHIIIJJJKKKLL\nVK APP ID (можно оставить пустым):\n```\n\nДалее потребуется ввести пароль от `sudo` пользователя и Telegram-token, остальные переменные необязательны.\n\n_Установщик поставит Docker и docker-compose, настроит переменные окружения и запустит контейнер для обновлений, а затем поднимет бота с его базой данных._\n\n### Обновление\nБот автоматически обновляется через образ на [dockerhub](https://hub.docker.com/r/kylmakalle/tgvkbot/tags?page=1\u0026ordering=last_updated), где на всякий случай фиксируются версии каждого коммита. \n\nСтандартный установщик поднимает [watchtower](https://containrrr.dev/watchtower), который раз в час проверяет обновления.\n\n\n### Ограничение пользователей\nЕсли по каким-то причинам хочется чтобы ботом пользовались исключительно определенные пользователи, то это можно сделать изменив файл конфигурации.\nПотребуется прописать параметр в таком виде, где числа - Telegram ID пользователей через запятую.\n\n`ALLOWED_USER_IDS=12345678,001238091`\n\nID можно узнать командой `/id` в боте или через других ботов/софт.\n\n\n### Кастомизация\nС недавнего времени бот поднимается с помощью готового docker образа. Если нужно сделать какую-то специфичную правку, то бота можно поднять через отдельный файл командой\n\n`docker-compose -f docker-compose.local.yml up`\n\nВсе остальные действия (`restart`, `stop`, ...) привязанные к \"локальному боту\" нужно выполнять с флагом `-f docker-compose.local.yml`\n\nНе забудьте отключить бота из образа командой `docker-compose down`\n\n# Установка в Dokku\n\nПодробнее о деплое через Dokku можно прочитать [здесь](https://dokku.com/docs/deployment/application-deployment/).\n\nНа сервере:\n\n```bash\ndokku apps:create tgvkbot\ndokku postgres:create tgvkbot_db\ndokku postgres:link tgvkbot_db tgvkbot\n\ndokku config:set tgvkbot BOT_TOKEN=\u003ctg_token\u003e [VK_APP_ID=\u003cvk_app_id\u003e ALLOWED_USER_IDS=\u003ctg_user_ids,...\u003e MAX_FILE_SIZE=\u003cnum\u003e ...]\n```\n\nНа локальном компьютере/где угодно в папке с репозиторием:\n\n```bash\ngit remote add dokku dokku@\u003cdokku_host_url\u003e:tgvkbot\ngit push dokku\n```\n\n\n# Сервисы музыки (Устаревшие)\nНиже прокси для музыки, которые использовали ранее. Сейчас они нерелевантны, но код открыт и в боте есть поддержка кастомных бэкендов музыки.\n\nAPI - https://github.com/Kylmakalle/thatmusic-api\n\nToken Refresher - https://github.com/Kylmakalle/vk-audio-token/tree/refresh-api\n\n\n# Лицензия\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkylmakalle%2Ftgvkbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkylmakalle%2Ftgvkbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkylmakalle%2Ftgvkbot/lists"}