Telegram Bot for reposting from VK
Project description
TG_AutoPoster
Бот, пересылающий записи из групп ВК в канал/чат/ЛС в Telegram.
Установка (обновление)
pip3 install -U TG-AutoPoster
Настройка
Внимание! Если у вас уже есть файл конфигурации в формате INI от старой версии бота он будет автоматически конвертирован в новый формат.
- Создайте файл config.yaml, скопируйте в него содержимое файла config.yaml.example и выполните настройку ключа vk
Параметр | Описание |
---|---|
login | Логин ВК |
pass | Пароль ВК |
token (необязательно) | Рекомендуется к использованию. Cервисный ключ доступа или ключ доступа пользователя (подробнее). Если он задан, то логин и пароль не используются. При его использовании не будут доступны аудиозаписи (при использовании сервисного ключа доступа также не будут доступны истории). Получить ключ доступа пользователя можно с помощью этого сервиса. |
- Получите ваши api_id и api_hash на https://my.telegram.org/apps и настройте ключ telegram (подробнее об Telegram API Keys здесь)
Параметр | Описание |
---|---|
api_id | App api_id |
api_hash | App api_hash |
bot_token | Токен Telegram бота, полученный у @BotFather |
- Если необходимо, настройте использование SOCKS прокси, добавив ключ proxy со следующим содержимым:
Параметр | Возможные значения | Описание |
---|---|---|
enabled | true, false | Использовать ли прокси |
hostname | IP адрес (или домен) прокси сервера | |
port | Порт прокси сервера | |
username (необязательно) | Имя пользователя | |
password (необязательно) | Пароль |
- Замените название ключа с domain1 на домен группы ВК (или на ссылку группы) и выполните соответствующую настройку этого ключа.
Параметр | Описание |
---|---|
channel | Список ID каналов/чатов в Telegram, разделенных пробелом, в которые отправлять посты из групп ВК |
last_id (необязательно) | ID последнего отправленного поста. Если параметр отсутствует, он будет добавлен автоматически со значением 0 |
pinned_id (необязательно) | ID закреплённого поста. |
last_story_id (необязательно) | ID последней отправленной истории. |
use_long_poll (необязательно) | Использовать Long Poll API для получения постов из своей группы (или в которой вы являетесь администратором) в режиме реального времени. Чтобы использовать Long Poll API, откройте раздел «Управление сообществом», на вкладке «Работа с API»→«Long Poll API» выберите «Включено», «Версия API»: 5.131. Также необходимо включить тип события «Записи на стене»: «Добавление» на вкладке «Типы событий». Значение параметра по умолчанию: false |
- Для изменения настроек автопостинга добавьте ключ settings хотя бы с одним из следующих параметров
Параметр | Возможные значения | Описание |
---|---|---|
sign_posts | true, false | Указывать ли автора поста (если это возможно) и ссылку на оригинальный пост. По умолчанию: true |
send_reposts | false, post_only, true | Отправлять ли репосты? Подробнее в config.yaml.example. По умолчанию отправка репостов отключена. |
send_stories | false, true | Отправлять ли истории? По умолчанию: false |
what_to_send | all, text, link, photo, doc, video, music, polls | Какие типы вложений отправлять. Подробнее в config.yaml.example. По умолчанию отправляются все вложения. |
stop_list | Абсолютный путь к файлу, содержащий стоп-слова (в файле должно быть по одному слову на каждой строке). Если вы не хотите использовать стоп-слова удалите этот параметр из файла конфигурации | |
blacklist | Абсолютный путь к файлу, содержащий слова, которые будут удалены из текста отправляемого поста. Поддерживаются регулярные выражения. | |
disable_notification | true, false | Отправляет сообщения молча. Пользователи получат уведомление без звука. По умолчанию: false |
disable_web_page_preview | true, false | Отключить предпросмотр ссылок в сообщениях. По умолчанию: true |
posts_count | Количество отправляемых ботом новых постов за раз. По умолчанию 11. |
Все необязательные параметры ключа settings могут быть заданы индивидуально для каждой группы
Автопостинг рекомендуется настраивать через чат с ботом. Подробнее можно узнать, отправив боту команду /help
Для работы с несколькими группами добавьте новые ключи в соответствии с пунктом № 4
Запуск
- Для запуска используйте TG_AutoPoster.sh или команду
python3 -m TG_AutoPoster
- Активируйте бота командой /start
Для доступных параметров командой строки используйте bash TG_AutoPoster.sh --help
или python3 -m TG_AutoPoster --help
Дополнительно: Использование Docker контейнера
Отчеты об ошибках и предложения отправлять в:
- GitHub Issues
- Telegram: @QwertyAdrian
Для пожертвований на развитие проекта:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for TG_AutoPoster-3.3.0b3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 107150a612d8bf0f99d0c41b0d0a34823a416fe2a5a3801dce09fb21ce516b4e |
|
MD5 | 00c120d57a668deeb4e9c3ef0fcc96cd |
|
BLAKE2b-256 | 258690e3fec4e88176962edbf77a7d43698df8a2986872c58df4df5a66e8d9d1 |