Skip to content
This repository has been archived by the owner on Dec 13, 2024. It is now read-only.

Latest commit

 

History

History
109 lines (91 loc) · 4.34 KB

README.md

File metadata and controls

109 lines (91 loc) · 4.34 KB
Raw

Bot for MMPro Bump

img1

🇷🇺 README на русском доступен здесь

Functionality

Feature Supported
Multithreading ✅
Binding a proxy to a session ✅
Claim daily grant ✅
Claim reward for friends ✅
Claim reward for tasks ✅
Automatic farming ✅
Automatic taps that account for enabled boosts ✅
Docker ✅

Options

Option Description
API_ID / API_HASH Platform data from which to launch a Telegram session (stock - Android)
SLEEP_BETWEEN_START Sleep before start each session (e.g. [20, 360])
ERRORS_BEFORE_STOP The number of failed requests after which the bot will stop
USE_PROXY_FROM_FILE Whether to use proxy from the bot/config/proxies.txt file (True / False)

You can obtain the API_ID and API_HASH after creating an application at my.telegram.org/apps

Quick start

Windows

  1. Ensure you have Python 3.10 or a newer version installed.
  2. Use INSTALL.bat to install, then specify your API_ID and API_HASH in the .env file.
  3. Use START.bat to launch the bot (or in the console: python main.py).

Linux

  1. Clone the repository: git clone https://github.com/Alexell/MMProBumpBot.git && cd MMProBumpBot
  2. Run the installation: chmod +x INSTALL.sh START.sh && ./INSTALL.sh, then specify your API_ID and API_HASH in the .env file.
  3. Use ./START.sh to run the bot (or in the console: python3 main.py).

Running in Docker

$ git clone https://github.com/Alexell/MMProBumpBot.git
$ cd MMProBumpBot
$ cp .env-example .env
$ nano .env # specify your API_ID and API_HASH, the rest can be left as default

Docker Compose (recommended)

$ docker-compose run bot -a 1 # first run for authorization (override arguments)
$ docker-compose start # start in background mode (default arguments: -a 2)

Docker

$ docker build -t mmpro_bump_bot .
$ docker run --name MMProBumpBot -v .:/app -it mmpro_bump_bot -a 1 # first run for authorization
$ docker rm MMProBumpBot # remove container to recreate with default arguments
$ docker run -d --restart unless-stopped --name MMProBumpBot -v .:/app mmpro_bump_bot # start in background mode (default arguments: -a 2)

Manual installation

You can download Repository by cloning it to your system and installing the necessary dependencies:

$ git clone https://github.com/Alexell/MMProBumpBot.git
$ cd MMProBumpBot

# Linux
$ python3 -m venv venv
$ source venv/bin/activate
$ pip3 install -r requirements.txt
$ cp .env-example .env
$ nano .env # specify your API_ID and API_HASH, the rest can be left as default
$ python3 main.py

# Windows (first, install Python 3.10 or a newer version)
> python -m venv venv
> venv\Scripts\activate
> pip install -r requirements.txt
> copy .env-example .env
> # specify your API_ID and API_HASH, the rest can be left as default
> python main.py

Also for quick launch you can use arguments:

$ python3 main.py --action (1/2)
# or
$ python3 main.py -a (1/2)

# 1 - Create session
# 2 - Run bot

Running a bot in the background (Linux)

$ cd MMProBumpBot

# with logging
$ setsid venv/bin/python3 main.py --action 2 >> app.log 2>&1 &

# without logging
$ setsid venv/bin/python3 main.py --action 2 > /dev/null 2>&1 &

# Now you can close the console, and the bot will continue its work.

Find the bot process

$ ps aux | grep "python3 main.py" | grep -v grep