Skip to content

Latest commit

 

History

History
309 lines (255 loc) · 15.2 KB

README.md

File metadata and controls

309 lines (255 loc) · 15.2 KB
Raw

Forks Stargazers MIT License Telegram Python


Bums Logo

Auto @Bums 2.1

Auto @Bums Farming Script
Report Bug • Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Account Management
  5. License

About The Project

Bums

An automated script/code made by @m3taphor on Python 3.10 for @bums or @bums_ton_bot, built using Bums app APIs. It supports multiple sessions through Pyrogram, with custom proxy support via an accounts.json configuration file.

(back to top)

Key Feature

  • Multithreading
  • Custom Binding on pyrogram session
    • Proxy Binding
    • User-Agent Binding
  • Track Bot Updates
  • Auto Login
  • Auto Days Sign-In
  • Auto collect Offline Bonus
  • Auto Tap
  • Auto Upgrade Tap Cards
  • Auto Upgrade Mine Cards
  • Auto Task
    • Join Channels
    • Change Name
  • Auto Collect Referred Balance
  • Auto Join Gang
  • Auto Solve Combo
  • Auto Open Box
    • Free Box
  • Auto Spins Lottery
  • Night-Mode Sleep

(back to top)

Getting Started

Warning

Please be aware that using this script may result in your @bums account being banned due to violating terms of service (e.g., cheating). Use at your own risk. The author assumes no responsibility for any consequences.

(back to top)

Obtain Telegram API

Warning

Please do NOT share your API ID & API HASH to anyone.

  1. Open your browser and go to the my.telegram.org
  2. Use your Telegram phone number to log in to the developer portal. You will receive a code via Telegram to authenticate.
  3. After logging in, go to the API development tools section and click on Create new application (if not exist).
  4. You will need to fill out some basic information for your application:
    • App title: Name your app (e.g., "My Telegram Bot").
    • Short name: A shorter version of your app's name.
    • URL: You can leave this blank or enter a website URL (optional).
    • Platform: Choose what kind of app you are developing (e.g., "Other").
  5. Once the application is created, you will see a page with your API ID and API HASH.

(back to top)

Env Management

Settings Description (Usage)
API_ID / API_HASH API Keys of telegram. Use to manage accounts, tutorial: (#obtain-telegram-api)
SUPPORT_AUTHOR Add random choice between REF_KEY & AUTHOR REF_KEY (default - True)
REF_KEY Start with refer, ID which is after startapp= (eg. ref_3CcrQyaN)
TRACK_BOT_UPDATES Track Bot JS Update, Prevent from API Changed [Safe Mode] (default - True)
AUTO_SIGN_IN Auto Check-in Daily (default - True)
AUTO_OPEN_FREE_BOX Auto Open daily free box (default - True)
AUTO_SPINS Auto Spin slot machine (default - True)
SPIN_COUNT [Spin] Count of spin per time [1/2/3/5/10/50] (default - 50)
NIGHT_MODE Script will sleep on Night hours (default - False)
NIGHT_TIME [Night Mode]: Hours of sleep on UTC Timezone [start, end] (default - [0, 7])
NIGHT_CHECKING [Night Mode]: Delay (in seconds) to check if night hours are over (default - [3600, 7200])
AUTO_UPGRADE_TAP_CARDS Auto upgrade Tap Cards, increase profit faster (default - True)
JACKPOT_LEVEL [Tap Card]: Maximum level for upgrading the Jackpot level card (default - 9)
CRIT_LEVEL [Tap Card]: Maximum level for upgrading the Crit Multiplier card (default - 8)
ENERGY_LEVEL [Tap Card]: Maximum level for upgrading the Max Energy card (default - 12)
TAP_LEVEL [Tap Card]: Maximum level for upgrading the Tap Reward card (default - 12)
ENERGY_REGEN_LEVEL [Tap Card]: Maximum level for upgrading the Energy Regen card (default - 10)
AUTO_UPGRADE_MINE_CARDS Auto upgrade Mine Cards, increase profit per hour (default - True)
MAX_CARD_PRICE_PURCHASE [Mine Card]: Maximum amount of card purchase on Mine cards (default - 10000)
PROFIT_UPGRADE [Mine Card]: Increase profit/hour & coin ratio of Mine cards. Avoid random purchase. (default - True)
AUTO_TAP Auto Tap/Click to collect coin (default - True)
TAPS_PER_BATCH [Auto Tap]: How many taps per batch (default - [15, 30])
DELAY_BETWEEN_TAPS [Auto Tap]: Delay (in seconds) between per batch of taps (default - [10, 20])
AUTO_TASK Auto complete tasks (default - True)
AUTO_JOIN_CHANNELS Auto join telegram channels to complete task (default - True)
AUTO_NAME_CHANGE Auto update name (on last name) to complete task (default - False)
COLLECT_REFER_BALANCE Auto collect referred balance (default - True)
JOIN_GANG Auto Join Gang (Squad) (default - True)
GANG_USERNAME [Join Gang]: Username of gang to join (eg. mainecode)
SOLVE_COMBO Solve daily combo (lottery) by proving answer on combo.json (default - False)
SLEEP_TIME Sleep delay (in seconds) before restarting session again (default - [2700, 4200])
START_DELAY Delay (in seconds) to start process (default - [5, 100])
IN_USE_SESSIONS_PATH Path of text file for appending in-use session (default - 'bot/config/used_sessions.txt')

(back to top)

Prerequisites

Important

Make sure you have only Python 3.10, or you will encounter errors.

Check the python version before installation

  • Windows OS

    python -v

  • Linux OS

    python3 —version

(back to top)

Quick Start

  1. Clone the repo 
    git clone https://github.com/m3taphor/Bums.git
  2. Obtain Api Keys from my.telegram.org, tutorial: (#obtain-telegram-api)
  3. Edit your .env configuration, tutorial: (#env-management)
  4. Run Batch/Bash file according to your operating system.
    • Run (Windows OS)
    run.bat
    • Run (Linux OS)
    ./run.sh

(back to top)

Manual Installation

Windows

  1. Clone the repo 
    git clone https://github.com/m3taphor/Bums.git
  2. Install Environment Variables 
    python -m venv venv
  3. Activate Environment Variables 
    venv\Scripts\activate
  4. Install Required Package 
    pip install -r requirements.txt
  5. Make .env file available 
    copy .env-example .env
  6. Edit .env file, as your will 
    notepad .env
  7. Run after all successful steps are done 
    python main.py

Linux

  1. Clone the repo 
    git clone https://github.com/m3taphor/Bums.git
  2. Install Environment Variables 
    python3 -m venv venv
  3. Activate Environment Variables 
    source venv/bin/activate
  4. Install Required Package 
    pip3 install -r requirements.txt
  5. Make .env file available 
    cp .env-example .env
  6. Edit .env file, as your will 
    nano .env
  7. Run after all successful steps are done 
    python3 main.py

(back to top)

Usage

Tip

Edit .env file before running script; Checkout (#env-management)

After the script is successfully installed, you will see two options:

  1. Run Bot
  2. Create Session

If you don’t have a Pyrogram session for your Telegram account, select Option 2 to create one. You will need to enter your registered Telegram phone number, the login OTP sent to your Telegram account, and your 2FA password. This will save your Pyrogram session in a folder named sessions

Warning

Do not share your session file with anyone, as it may lead to losing access to your Telegram account.

If you already have a existing Pyrogram session, simply place it in the sessions folder, then choose Option 1 (Run Bot) to start the mining or farming process.

(back to top)

Account Management

You can manage your account or modify your proxy by editing the accounts.json file located in the sessions folder. Here’s an example of accounts.json:

[
  {
    "session_name": "name_example",
    "user_agent": "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.6422.165 Mobile Safari/537.36",
    "proxy": "type://user:pass:ip:port"  # "proxy": "" - if you dont use proxy
  }
]

(back to top)

License

Distributed under the MIT License. The GNU General Public License is a free, copyleft license for software and other kinds of works.

More Info on LICENSE file.

(back to top)