m3taphor / Bums

Auto farm and mining script for Bums (Bums Bot) / @bums_ton_bot. Made by @m3taphor on Python. Supports auto task, tap, collect and more. Join: https://t.me/hidden_coding
https://t.me/bums/app?startapp=ref_3CcrQyaN
Apache License 2.0
9 stars 1 forks source link
bot bums bums-airdrop bums-auto bums-auto-click bums-auto-clicker bums-auto-farm bums-auto-tap bums-farm crypto memecoin telegram telegram-airdrop telegram-bot

Forks Stargazers MIT License Telegram Python


Bums Logo

Auto @Bums

Auto @Bums Farming Script
Report BugRequest 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

(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 betweeb REF_KEY & AUTHOR REF_KEY (by default - True)
REF_KEY Start with refer, ID which is after startapp= (eg. ref_3CcrQyaN)
NIGHT_MODE Script will sleep on Night hours (by default - False)
NIGHT_TIME [Night Mode]: Hours of sleep on UTC Timezone [start, end] (by default - [0, 7])
NIGHT_CHECKING [Night Mode]: Delay (in seconds) to check if night hours are over (by default - [3600, 7200])
AUTO_UPGRADE_TAP_CARDS Auto upgrade Tap Cards, increase profit faster (by default - True)
JACKPOT_LEVEL [Tap Card]: Maximum level for upgrading the Jackpot level card (by default - 9)
CRIT_LEVEL [Tap Card]: Maximum level for upgrading the Crit Multiplier card (by default - 8)
ENERGY_LEVEL [Tap Card]: Maximum level for upgrading the Max Energy card (by default - 12)
TAP_LEVEL [Tap Card]: Maximum level for upgrading the Tap Reward card (by default - 12)
ENERGY_REGEN_LEVEL [Tap Card]: Maximum level for upgrading the Energy Regen card (by 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 (by default - 10000)
AUTO_TAP Auto Tap/Click to collect coin (by default - True)
TAPS_PER_BATCH [Auto Tap]: How many taps per batch (by default - [15, 30])
DELAY_BETWEEN_TAPS [Auto Tap]: Delay (in seconds) between per batch of taps (by 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 (add emoji) to complete task (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

(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)