Binary Userbot - Termux
bincoreБыстрый старт
pkg update && pkg upgrade -y
pkg install -y git python python-pip ffmpeg nano clang make openssl libffi
termux-setup-storage
git clone https://github.com/binary166/BinaryUserBot
cd BinaryUserBot
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then cd BinaryUserBot; fi
python -m pip install --upgrade pip setuptools wheel
if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; else python -m pip install telethon aiohttp yt-dlp; fi
nano config.py
python main.py
Ниже идет более подробная помощь, запуск через tmux и ответы на вопросы.
Эта инструкция подходит для Android через Termux. Для постоянной работы 24/7 лучше использовать VPS, потому что Android может останавливать фоновые процессы.
1. Что нужно заранее
Подготовьте:
- Android-смартфон.
- Telegram-аккаунт, на котором будет работать userbot.
- Termux из F-Droid.
- Telegram API_ID и API_HASH.
- Ваш Telegram User ID.
- OpenRouter API Token, если нужны AI-функции.
Репозиторий:
https://github.com/binary166/BinaryUserBot
2. Обязательная подписка
Перед первым запуском обязательно подпишитесь с того Telegram-аккаунта, на котором будет работать userbot:
Это обязательное условие для нормальной работы функций, связанных со скам-базой, новостями, обновлениями, модулями и поддержкой проекта.
3. Установка правильного Termux
Устанавливайте Termux из F-Droid:
https://f-droid.org/packages/com.termux/
Не используйте старую версию из Google Play: в ней часто не работают пакеты и обновления.
После установки откройте Termux.
4. Получение Telegram API ID и API Hash
- Откройте
- https://my.telegram.org в браузере.
- Войдите по номеру телефона Telegram.
- Перейдите в API development tools.
- Создайте приложение. Название и описание можно указать любые.
- Скопируйте:App api_id
- App api_hash
Пример:
API_ID = 12345678
API_HASH = "abcdef123456abcdef123456abcdef12"
Не передавайте эти данные другим людям.
5. Получение Telegram User ID
- Откройте Telegram.
- Напишите боту
- https://t.me/userinfobot.
- Скопируйте числовой ID.
Пример:
MY_ID = 750545571
6. Получение OpenRouter API Token
Токен нужен для AI-команд, например .gpt, .ac, .lol, .troll.
- Откройте
- https://openrouter.ai.
- Зарегистрируйтесь или войдите.
- Перейдите в Settings -> API Keys.
- Создайте ключ через Create Key.
- Скопируйте токен.
Если AI-функции не нужны:
OR_TOKEN = ""
7. Обновление Termux и установка зависимостей
pkg update && pkg upgrade -y
pkg install -y git python python-pip ffmpeg nano clang make openssl libffi
Проверка:
python --version
git --version
ffmpeg -version
Если хотите сохранять файлы в память телефона, разрешите доступ к хранилищу:
termux-setup-storage
Android попросит разрешение. Нажмите Allow / Разрешить.
8. Скачивание проекта
cd ~
git clone https://github.com/binary166/BinaryUserBot
cd BinaryUserBot
В некоторых версиях проекта внутри может быть еще одна папка BinaryUserBot. Перейдите в нее, если там лежит main.py:
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then
cd BinaryUserBot
fi
Проверьте, что вы в папке с main.py:
ls
Если main.py не видно:
find . -name main.py
Перейдите в папку, которую покажет команда.
9. Установка Python-библиотек
Обновите инструменты установки:
python -m pip install --upgrade pip setuptools wheel
Если есть requirements.txt:
python -m pip install -r requirements.txt
Если файла нет:
python -m pip install telethon aiohttp yt-dlp
Автоматический вариант:
if [ -f requirements.txt ]; then
python -m pip install -r requirements.txt
else
python -m pip install telethon aiohttp yt-dlp
fi
10. Настройка config.py
Откройте файл:
nano config.py
Заполните основные поля:
API_ID = 12345678
API_HASH = "abcdef123456abcdef123456abcdef12"
PHONE = "+79001234567"
PASSWORD_2FA = ""
MY_ID = 123456789
OR_TOKEN = ""
Расшифровка:
- API_ID - число с my.telegram.org.
- API_HASH - строка с my.telegram.org.
- PHONE - ваш номер Telegram в международном формате.
- PASSWORD_2FA - пароль двухфакторной аутентификации Telegram. Если его нет, оставьте "".
- MY_ID - ваш числовой Telegram ID.
- OR_TOKEN - токен OpenRouter. Если AI не нужен, оставьте "".
Сохранить в nano:
Ctrl + O
Enter
Ctrl + X
11. Первый запуск
python main.py
При первом запуске Telegram может попросить:
- Ввести код из Telegram.
- Ввести пароль 2FA, если он установлен.
После успешного входа появится файл *.session. Не передавайте его другим людям.
12. Проверка работы
- Откройте Telegram.
- Проверьте, что аккаунт подписан на:@GID_ScamBase
- @Binary_News
- @binary_ub
- Напишите .help в чате.
- Если бот отвечает, установка завершена.
13. Повторный запуск
cd ~/BinaryUserBot
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then
cd BinaryUserBot
fi
python main.py
14. Более стабильный запуск через tmux
Установите tmux:
pkg install -y tmux
Запретите Android засыпать процессу:
termux-wake-lock
Создайте сессию:
tmux new -s binarybot
Внутри сессии:
cd ~/BinaryUserBot
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then
cd BinaryUserBot
fi
python main.py
Выйти из сессии без остановки:
Ctrl + B, затем D
Вернуться:
tmux attach -t binarybot
Снять блокировку сна:
termux-wake-unlock
Важно: даже с tmux Android может остановить Termux. Для стабильной работы 24/7 используйте VPS.
15. Добавление Termux в исключения батареи
Чтобы Android реже останавливал Termux:
- Откройте настройки Android.
- Найдите Battery / Батарея.
- Найдите Termux.
- Отключите оптимизацию батареи для Termux.
- Разрешите работу в фоне, если такая настройка есть.
Названия пунктов зависят от модели телефона.
16. Обновление
Остановите бота и выполните:
cd ~/BinaryUserBot
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then
cd BinaryUserBot
fi
git pull
python -m pip install --upgrade pip setuptools wheel
if [ -f requirements.txt ]; then
python -m pip install -r requirements.txt --upgrade
else
python -m pip install --upgrade telethon aiohttp yt-dlp
fi
python main.py
17. Резервная копия
Сохраните:
- config.py
- *.session
- settings.json, если есть
- notes.json, если есть
- папку modules, если есть
Файл *.session равен доступу к аккаунту. Не отправляйте его никому.
Если нужен доступ к файлам через память телефона, после termux-setup-storage путь обычно такой:
~/storage/shared
18. Частые ошибки
pkg update выдает ошибки
Попробуйте сменить зеркало:
termux-change-repo
Выберите основной репозиторий Termux и повторите:
pkg update && pkg upgrade -y
ModuleNotFoundError
python -m pip install telethon aiohttp yt-dlp
Ошибка установки aiohttp
Установите инструменты сборки:
pkg install -y clang make openssl libffi
python -m pip install --upgrade pip setuptools wheel
python -m pip install aiohttp
main.py не найден
find . -name main.py
Перейдите в папку, которую покажет команда.
ffmpeg не найден
pkg install -y ffmpeg
ffmpeg -version
Бот остановился после закрытия Termux
Это нормально для Android. Используйте:
termux-wake-lock
tmux new -s binarybot
Но для постоянной работы лучше VPS.
FloodWaitError
Это лимит Telegram. Подождите указанное время и не перезапускайте бота слишком часто.
AI-команды не работают
Проверьте:
- заполнен ли OR_TOKEN;
- активен ли ключ OpenRouter;
- есть ли доступ к модели;
- нет ли лишних пробелов в токене.
Команды .scam или .lastnews не работают
Проверьте обязательную подписку:
- @GID_ScamBase
- @Binary_News
- @binary_ub
19. Короткая установка для Termux
pkg update && pkg upgrade -y
pkg install -y git python python-pip ffmpeg nano clang make openssl libffi
cd ~
git clone https://github.com/binary166/BinaryUserBot
cd BinaryUserBot
if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then cd BinaryUserBot; fi
python -m pip install --upgrade pip setuptools wheel
if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; else python -m pip install telethon aiohttp yt-dlp; fi
nano config.py
python main.py