TG_AutoPoster

Бот, пересылающий записи из групп ВК в канал/чат/ЛС в Telegram.

Установка (обновление)

shell script pip3 install -U TG-AutoPoster

Настройка

1. Создайте файл config.yaml, скопируйте в него содержимое файла config.yaml.example и выполните настройку ключа vk

| Параметр | Описание | |:----------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | login | Логин ВК | | pass | Пароль ВК | | token (необязательно) | Рекомендуется к использованию. Cервисный ключ доступа или ключ доступа пользователя (подробнее). Если он задан, то логин и пароль игнорируются. При его использовании не будут доступны аудиозаписи (при использовании сервисного ключа доступа также не будут доступны истории). Получить ключ доступа пользователя можно с помощью этого сервиса. |

1. Получите ваши api_id и api_hash на https://my.telegram.org/apps и настройте ключ telegram (подробнее об Telegram API Keys здесь)

| Параметр | Описание | |:---------:|:----------------------------------------------------------------------:| | apiid | App apiid | | apihash | App apihash | | bot_token | Токен Telegram бота, полученный у @BotFather |

1. Если необходимо, настройте использование SOCKS5 прокси, добавив ключ proxy со следующим содержимым:

| Параметр | Возможные значения | Описание | |:------------------------:|:------------------:|:--------------------------------------:| | enabled | true, false | Использовать ли прокси | | hostname | | IP адрес (или домен) прокси сервера | | port | | Порт прокси сервера | | username (необязательно) | | Имя пользователя | | password (необязательно) | | Пароль |

Запуск

1. Для запуска используйте консольную команду python3 -m TG_AutoPoster
   
2. Активируйте бота в чате командой /start

Автопостинг рекомендуется настраивать через чат с ботом. Подробнее можно узнать, отправив боту команду /help

Для доступных параметров командой строки используйте python3 -m TG_AutoPoster --help

По умолчанию бот проверяет группы на наличие новых постов раз в час. Если необходимо изменить период проверки постов запустите бота с параметром командной строки --sleep N, где N — значение в секундах. Не рекомендуется устанавливать малое значение, так как это может привести к заморозке страницы ВК (подробнее).

Описание настроек группы

| Параметр | Описание | |:-----------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | channel | Один или несколько ID каналов/чатов в Telegram, в которые отправлять посты из групп ВК | | lastid (необязательно) | ID последнего отправленного поста. Если параметр отсутствует, он будет добавлен автоматически со значением 0 | | pinnedid (необязательно) | ID закреплённого поста. | | laststoryid (необязательно) | ID последней отправленной истории. | | uselongpoll (необязательно) | Использовать Long Poll API для получения постов из своей группы (или в которой вы являетесь администратором) в режиме реального времени. Чтобы использовать Long Poll API, откройте раздел «Управление сообществом», на вкладке «Работа с API»→«Long Poll API» выберите «Включено», «Версия API»: 5.131. Также необходимо включить тип события «Записи на стене»: «Добавление» на вкладке «Типы событий».
Значение параметра по умолчанию: false |

Описание настроек автопостинга (ключ settings)

| Параметр | Возможные значения | Описание | |:------------------------:|:-----------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | signposts | true, false | Указывать ли автора поста (если это возможно) и ссылку на оригинальный пост. По умолчанию: true | | sendreposts | false, postonly, true | Отправлять ли репосты? Подробнее в config.yaml.example. По умолчанию отправка репостов отключена. | | sendstories | false, true | Отправлять ли истории? По умолчанию: false | | whattosend | all, text, link, photo, doc, video, music, polls | Какие типы вложений отправлять. Подробнее в config.yaml.example. По умолчанию отправляются все вложения. | | stoplist | | Абсолютный путь к файлу, содержащий стоп-слова (по одному слову на каждой строке). Если вы не хотите использовать стоп-слова удалите этот параметр из файла конфигурации | | invertstoplist | true, false | Инвертировать список стоп-слов (по умолчанию отключено). Будут отправляться посты, в которых содержатся указанные в списке слова или регулярные выражения | | blacklist | | Абсолютный путь к файлу, содержащий слова, которые будут удалены из текста отправляемого поста. Поддерживаются регулярные выражения. | | disablenotification | true, false | Отправляет сообщения молча. Пользователи получат уведомление без звука. По умолчанию: false | | disablewebpagepreview | true, false | Отключить предпросмотр ссылок в сообщениях. По умолчанию: true | | postscount | | Количество отправляемых ботом новых постов за раз. По умолчанию 11. | | header | Текст с форматированием Markdown | Текст, который будет добавлен в начало сообщения | | footer | Текст с форматированием Markdown | Текст, который будет добавлен в конец сообщения |

Все параметры ключа settings могут быть заданы индивидуально для каждой группы

Дополнительно: Использование Docker контейнера

Отчеты об ошибках и предложения отправлять в: 1. GitHub Issues 2. Telegram: @QwertyAdrian

Для пожертвований на развитие проекта: 1. Bitcoin: 1H1UVnXgvcLo3RWmxuYmi7b16ADo6XBWw5 2. TON: EQD42Z5d8d1gT1uSpKTAaLYHlQ95vdMXrlNlYMpSFpQawwuY