Skip to content

Smart Util is the most complete bot designed to assist you with a wide array of tools. By @abirxdhack & @TheSmartDevs.

Notifications You must be signed in to change notification settings

TheSmartDevs/SmartUtilBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

75 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SmartUtilBot πŸ’₯🌟

SmartUtilBot is a powerful Telegram bot built with Python and Pyrogram, designed to provide a wide range of utilities including credit card scraping, media downloading, AI-powered tools, and more. This bot leverages multiple APIs and services to deliver robust functionality for both casual and advanced users. ✨

Features 🌟

  • Start Smart Tool: κœ±α΄›α΄€Κ€α΄›_κœ±α΄α΄€Κ€α΄›_✘_α΄›α΄α΄ΚŸβ†―
  • Talk to SmartAI: α΄›α΄€ΚŸα΄‹_ᴛᴏ_✘_κœ±α΄α΄€Κ€α΄›α΄€Ιͺβ†―
  • C^C Generator:* α΄„*^α΄„_✘_ɒᴇɴᴇʀᴀᴛᴏʀ↯
  • Check B^IN:* α΄„Κœα΄‡α΄„α΄‹_✘_Κ™*^ΙͺΙ΄β†―
  • Check Multiple B^INs:* α΄„Κœα΄‡α΄„α΄‹_α΄α΄œΚŸα΄›Ιͺα΄˜ΚŸα΄‡_✘_Κ™*^ΙͺΙ΄κœ±β†―
  • Extrapolate Credit Card Data from B^IN:* ᴇxα΄›Κ€α΄€α΄˜α΄ΚŸα΄€α΄›α΄‡_ᴄʀᴇᴅΙͺα΄›_✘_α΄„α΄€Κ€α΄…_α΄…α΄€α΄›α΄€_κœ°Κ€α΄α΄_Κ™*^ΙͺΙ΄β†―
  • Find Top B^IN from Combo:* ꜰΙͺΙ΄α΄…_α΄›α΄α΄˜_✘_Κ™*^ΙͺΙ΄_κœ°Κ€α΄α΄_ᴄᴏᴍʙᴏ↯
  • C^C Scrape:* α΄„*^α΄„_✘_κœ±α΄„Κ€α΄€α΄˜α΄‡β†―
  • Filter C^Cs:* ꜰΙͺΚŸα΄›α΄‡Κ€_✘_α΄„*^α΄„κœ±β†―
  • Multi C^C Generator:* α΄α΄œΚŸα΄›Ιͺ_α΄„*^α΄„_✘_ɒᴇɴᴇʀᴀᴛᴏʀ↯
  • Multi C^C Scrape:* α΄α΄œΚŸα΄›Ιͺ_α΄„*^α΄„_✘_κœ±α΄„Κ€α΄€α΄˜α΄‡β†―
  • Find B^IN Database:* ꜰΙͺΙ΄α΄…_Κ™*^ΙͺΙ΄_✘_α΄…α΄€α΄›α΄€Κ™α΄€κœ±α΄‡β†―
  • Filter Specific B^IN Cards:* ꜰΙͺΚŸα΄›α΄‡Κ€_κœ±α΄˜α΄‡α΄„ΙͺꜰΙͺα΄„_✘_Κ™*^ΙͺΙ΄_α΄„α΄€Κ€α΄…κœ±β†―
  • Remove Specific B^IN Cards:* ʀᴇᴍᴏᴠᴇ_κœ±α΄˜α΄‡α΄„ΙͺꜰΙͺα΄„_✘_Κ™*^ΙͺΙ΄_α΄„α΄€Κ€α΄…κœ±β†―
  • Ask Question to ChatGPT-3.5: α΄€κœ±α΄‹_Η«α΄œα΄‡κœ±α΄›Ιͺᴏɴ_✘_ᴛᴏ_α΄„Κœα΄€α΄›Ι’α΄˜α΄›_3.5β†―
  • Ask Question to ChatGPT-4: α΄€κœ±α΄‹_Η«α΄œα΄‡κœ±α΄›Ιͺᴏɴ_✘_ᴛᴏ_α΄„Κœα΄€α΄›Ι’α΄˜α΄›_4β†―
  • Ask Question to Gemini AI: α΄€κœ±α΄‹_Η«α΄œα΄‡κœ±α΄›Ιͺᴏɴ_✘_ᴛᴏ_ɒᴇᴍΙͺΙ΄Ιͺ_α΄€Ιͺβ†―
  • Image Analysis: Ιͺᴍᴀɒᴇ_α΄€Ι΄α΄€ΚŸΚκœ±Ιͺꜱ_✘_ʀᴇᴀᴅ_Ιͺᴍᴀɒᴇ↯
  • Base64 Encode: Κ™α΄€κœ±α΄‡64_✘_ᴇɴᴄᴏᴅᴇ↯
  • Base64 Decode: Κ™α΄€κœ±α΄‡64_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Base32 Encode: Κ™α΄€κœ±α΄‡32_✘_ᴇɴᴄᴏᴅᴇ↯
  • Base32 Decode: Κ™α΄€κœ±α΄‡32_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Binary Encode: Κ™Ιͺɴᴀʀʏ_✘_ᴇɴᴄᴏᴅᴇ↯
  • Binary Decode: Κ™Ιͺɴᴀʀʏ_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Hex Encode: Κœα΄‡x_✘_ᴇɴᴄᴏᴅᴇ↯
  • Hex Decode: Κœα΄‡x_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Octal Encode: α΄α΄„α΄›α΄€ΚŸ_✘_ᴇɴᴄᴏᴅᴇ↯
  • Octal Decode: α΄α΄„α΄›α΄€ΚŸ_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Reverse Text: Κ€α΄‡α΄ α΄‡Κ€κœ±α΄‡_✘_ᴛᴇxα΄›β†―
  • Transform to Capital Letters: α΄›Κ€α΄€Ι΄κœ±κœ°α΄Κ€α΄_ᴛᴏ_✘_α΄„α΄€α΄˜Ιͺα΄›α΄€ΚŸ_ΚŸα΄‡α΄›α΄›α΄‡Κ€κœ±β†―
  • Transform to Small Letters: α΄›Κ€α΄€Ι΄κœ±κœ°α΄Κ€α΄_ᴛᴏ_✘_κœ±α΄α΄€ΚŸΚŸ_ΚŸα΄‡α΄›α΄›α΄‡Κ€κœ±β†―
  • Count Words: α΄„α΄α΄œΙ΄α΄›_✘_α΄‘α΄Κ€α΄…κœ±β†―
  • Download Facebook Video: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_κœ°α΄€α΄„α΄‡Κ™α΄α΄α΄‹_α΄ Ιͺᴅᴇᴏ↯
  • Download Pinterest Video: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_ᴘΙͺΙ΄α΄›α΄‡Κ€α΄‡κœ±α΄›_α΄ Ιͺᴅᴇᴏ↯
  • Download YouTube Video: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_Κα΄α΄œα΄›α΄œΚ™α΄‡_α΄ Ιͺᴅᴇᴏ↯
  • Download Instagram Reels: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_ΙͺΙ΄κœ±α΄›α΄€Ι’Κ€α΄€α΄_Κ€α΄‡α΄‡ΚŸκœ±β†―
  • Download Spotify Track: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_κœ±α΄˜α΄α΄›Ιͺꜰʏ_α΄›Κ€α΄€α΄„α΄‹β†―
  • Download YouTube Audio: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_Κα΄α΄œα΄›α΄œΚ™α΄‡_α΄€α΄œα΄…Ιͺᴏ↯
  • Convert Video to Audio: ᴄᴏɴᴠᴇʀᴛ_α΄ Ιͺᴅᴇᴏ_✘_ᴛᴏ_α΄€α΄œα΄…Ιͺᴏ↯
  • Extract YouTube Video Tags: ᴇxα΄›Κ€α΄€α΄„α΄›_✘_Κα΄α΄œα΄›α΄œΚ™α΄‡_α΄ Ιͺᴅᴇᴏ_α΄›α΄€Ι’κœ±β†―
  • Download YouTube Thumbnail: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_Κα΄α΄œα΄›α΄œΚ™α΄‡_α΄›Κœα΄œα΄Κ™Ι΄α΄€ΙͺΚŸβ†―
  • Fix Word Spelling: ꜰΙͺx_✘_ᴑᴏʀᴅ_κœ±α΄˜α΄‡ΚŸΚŸΙͺΙ΄Ι’β†―
  • Fix Grammatical Issues: ꜰΙͺx_✘_ɒʀᴀᴍᴍᴀᴛΙͺα΄„α΄€ΚŸ_Ιͺκœ±κœ±α΄œα΄‡κœ±β†―
  • Check Synonyms and Antonyms: α΄„Κœα΄‡α΄„α΄‹_✘_ꜱʏɴᴏɴʏᴍꜱ_α΄€Ι΄α΄…_α΄€Ι΄α΄›α΄Ι΄Κα΄κœ±β†―
  • Check Pronunciation: α΄„Κœα΄‡α΄„α΄‹_✘_α΄˜Κ€α΄Ι΄α΄œΙ΄α΄„Ιͺα΄€α΄›Ιͺᴏɴ↯
  • Filter/Extract Mails: ꜰΙͺΚŸα΄›α΄‡Κ€_✘_ᴇxα΄›Κ€α΄€α΄„α΄›_ᴍᴀΙͺΚŸκœ±β†―
  • Filter/Extract Mail Passwords: ꜰΙͺΚŸα΄›α΄‡Κ€_✘_ᴇxα΄›Κ€α΄€α΄„α΄›_ᴍᴀΙͺʟ_α΄˜α΄€κœ±κœ±α΄‘α΄Κ€α΄…κœ±β†―
  • Mail-Pass Scrape for GC Targets: ᴍᴀΙͺʟ-α΄˜α΄€κœ±κœ±_✘_κœ±α΄„Κ€α΄€α΄˜α΄‡_κœ°α΄Κ€_Ι’α΄„_α΄›α΄€Κ€Ι’α΄‡α΄›κœ±β†―
  • Mail Scrape: ᴍᴀΙͺʟ_✘_κœ±α΄„Κ€α΄€α΄˜α΄‡β†―
  • Generate Random Mail with Password: ɒᴇɴᴇʀᴀᴛᴇ_✘_ʀᴀɴᴅᴏᴍ_ᴍᴀΙͺʟ_α΄‘Ιͺα΄›Κœ_α΄˜α΄€κœ±κœ±α΄‘α΄Κ€α΄…β†―
  • Check Recent 10 Mails: α΄„Κœα΄‡α΄„α΄‹_✘_ʀᴇᴄᴇɴᴛ_10_ᴍᴀΙͺΚŸκœ±β†―
  • Pyrogram Telegram String Session: α΄˜ΚΚ€α΄Ι’Κ€α΄€α΄_✘_α΄›α΄‡ΚŸα΄‡Ι’Κ€α΄€α΄_κœ±α΄›Κ€ΙͺΙ΄Ι’_κœ±α΄‡κœ±κœ±Ιͺᴏɴ↯
  • Telethon Telegram String Session: α΄›α΄‡ΚŸα΄‡α΄›Κœα΄Ι΄_✘_α΄›α΄‡ΚŸα΄‡Ι’Κ€α΄€α΄_κœ±α΄›Κ€ΙͺΙ΄Ι’_κœ±α΄‡κœ±κœ±Ιͺᴏɴ↯
  • Real-Time Token Prices: Κ€α΄‡α΄€ΚŸ-α΄›Ιͺᴍᴇ_✘_ᴛᴏᴋᴇɴ_α΄˜Κ€Ιͺα΄„α΄‡κœ±β†―
  • Latest P2P Trades in BDT: ΚŸα΄€α΄›α΄‡κœ±α΄›_✘_ᴘ2ᴘ_α΄›Κ€α΄€α΄…α΄‡κœ±_ΙͺΙ΄_Κ™α΄…α΄›β†―
  • Top Gainers List: α΄›α΄α΄˜_✘_Ι’α΄€ΙͺΙ΄α΄‡Κ€κœ±_ʟΙͺκœ±α΄›β†―
  • Top Losers List: α΄›α΄α΄˜_✘_ΚŸα΄κœ±α΄‡Κ€κœ±_ʟΙͺκœ±α΄›β†―
  • Get Info About Stripe Key: ɒᴇᴛ_✘_Ιͺɴꜰᴏ_α΄€Κ™α΄α΄œα΄›_κœ±α΄›Κ€Ιͺα΄˜α΄‡_ᴋᴇʏ↯
  • Check Stripe Key Live or Dead: α΄„Κœα΄‡α΄„α΄‹_✘_κœ±α΄›Κ€Ιͺα΄˜α΄‡_ᴋᴇʏ_ʟΙͺᴠᴇ_ᴏʀ_ᴅᴇᴀᴅ↯
  • Get IP Information: ɒᴇᴛ_✘_Ιͺᴘ_ΙͺΙ΄κœ°α΄Κ€α΄α΄€α΄›Ιͺᴏɴ↯
  • Proxy Checker: α΄˜Κ€α΄xʏ_✘_α΄„Κœα΄‡α΄„α΄‹α΄‡Κ€β†―
  • Take Website Screenshot: ᴛᴀᴋᴇ_✘_α΄‘α΄‡Κ™κœ±Ιͺᴛᴇ_κœ±α΄„Κ€α΄‡α΄‡Ι΄κœ±Κœα΄α΄›β†―
  • Download Website Source Code: α΄…α΄α΄‘Ι΄ΚŸα΄α΄€α΄…_✘_α΄‘α΄‡Κ™κœ±Ιͺᴛᴇ_κœ±α΄α΄œΚ€α΄„α΄‡_ᴄᴏᴅᴇ↯
  • Extract Text from Image: ᴇxα΄›Κ€α΄€α΄„α΄›_✘_ᴛᴇxα΄›_κœ°Κ€α΄α΄_Ιͺᴍᴀɒᴇ↯
  • Generate Random Address: ɒᴇɴᴇʀᴀᴛᴇ_✘_ʀᴀɴᴅᴏᴍ_α΄€α΄…α΄…Κ€α΄‡κœ±κœ±β†―
  • Check Weather: α΄„Κœα΄‡α΄„α΄‹_✘_α΄‘α΄‡α΄€α΄›Κœα΄‡Κ€β†―
  • Get User/Group/Channel Info: ɒᴇᴛ_✘_α΄œκœ±α΄‡Κ€_Ι’Κ€α΄α΄œα΄˜_α΄„Κœα΄€Ι΄Ι΄α΄‡ΚŸ_ΙͺΙ΄κœ°α΄β†―
  • Get Full Help: ɒᴇᴛ_✘_ꜰᴜʟʟ_Κœα΄‡ΚŸα΄˜β†―
  • Broadcast Admin: Κ™Κ€α΄α΄€α΄…α΄„α΄€κœ±α΄›_✘_ᴀᴅᴍΙͺΙ΄β†―
  • Restart Me: Κ€α΄‡κœ±α΄›α΄€Κ€α΄›_✘_ᴍᴇ↯
  • Change Entire Database Settings: α΄„Κœα΄€Ι΄Ι’α΄‡_✘_ᴇɴᴛΙͺʀᴇ_α΄…α΄€α΄›α΄€Κ™α΄€κœ±α΄‡β†―

Requirements πŸ’₯🌟

  • Python 3.9 Or Above 🐍
    Note: Python Version 3.9-3.12 Full Supported 3.13 Maybe But Not Tested

  • 3 MongoDB URLs 🌐
    Need 3 MONGO_URL Must For 3 DB Client So That's A Mandatory VARS

  • Supported OS ❄️

    • Ubuntu 22.04+ πŸ’«
    • Debian 10+ 🌟
  • Environment Variables πŸ‘€
    Make sure to provide the following Telegram-specific variables:

    • API_ID
    • API_HASH
    • BOT_TOKEN
    • SESSION_STRING
  • Additional Info ✘
    Check the Vars List for more configuration details and setup instructions!

Installation

Follow these steps to set up and deploy SmartUtilBot:

  1. Clone the Repository:

    git clone https://github.com/TheSmartDevs/SmartUtilBot.git
    cd SmartUtilBot
  2. Install FFmpeg: FFmpeg is required for media processing and must be installed using your system's package manager. For Ubuntu/Debian, run:

    sudo apt update
    sudo apt install ffmpeg

    Note: FFmpeg cannot be installed via pip.

  3. Install Python Dependencies:

    pip3 install -r requirements.txt
  4. Set Up Environment Variables:

    • Create a .env file in the project root or edit config.py directly.
    • Populate the required variables (see Environment Variables).
    • Refer to the .env example and the Mandatory/Optional Vars sections for guidance.
  5. Deploy the Bot:

    • Direct Deployment:
      python3 main.py
    • Run with Screen (Recommended for Persistent Sessions):
      screen -S SmartUtilBot
      python3 main.py
      To detach from the screen session, press Ctrl+A followed by D. To reattach:
      screen -r SmartUtilBot
    • Deploy with Docker Compose: Ensure Docker and Docker Compose are installed. The bot will run in a containerized environment with dependencies managed automatically.
      docker compose up --build --remove-orphans
      To stop the bot:
      docker compose down

Special Note: πŸ’«: Configure the bot by setting values in either the .env file or directly in config.pyβ€”your choice! The default YouTube cookies path is SmartUtilBot/cookies.txt. Admins can dynamically adjust variables using the /settings command within the bot for quick and easy management. πŸ‘¨β€πŸ’»

Deploy to Heroku

Deploy

Heroku Deployment Tutorial

Deploying SmartUtilBot to Heroku is a straightforward process. Follow these steps to get your bot running on Heroku:

  1. Create a Heroku Account:

    • Sign up for a free account at Heroku if you don’t already have one.
  2. Install Heroku CLI:

    • Download and install the Heroku Command Line Interface (CLI) from Heroku Dev Center.
    • Verify installation by running:
      heroku --version
  3. Log in to Heroku:

    • Run the following command and follow the prompts to log in:
      heroku login
  4. Clone the Repository:

    • If you haven’t already, clone the SmartUtilBot repository:
      git clone https://github.com/TheSmartDevs/SmartUtilBot.git
      cd SmartUtilBot
  5. Create a Heroku App:

    • Create a new Heroku app by running:
      heroku create your-app-name
      Replace your-app-name with a unique name for your app.
  6. Install FFmpeg Buildpack:

    • Heroku requires a buildpack to install FFmpeg. Add the FFmpeg buildpack to your app:
      heroku buildpacks:add https://github.com/jonathanong/heroku-buildpack-ffmpeg-latest.git -a your-app-name
    • Add the Python buildpack as well:
      heroku buildpacks:add heroku/python -a your-app-name
  7. Set Environment Variables:

    • Configure the mandatory and optional environment variables (see Environment Variables) in Heroku:
      heroku config:set API_ID=your_api_id -a your-app-name
      heroku config:set API_HASH=your_api_hash -a your-app-name
      heroku config:set BOT_TOKEN=your_bot_token -a your-app-name
      heroku config:set SESSION_STRING=your_session_string -a your-app-name
      heroku config:set OPENAI_API_KEY=your_openai_key -a your-app-name
      heroku config:set MONGO_URL=your_mongo_url -a your-app-name
      heroku config:set DATABASE_URL=your_database_url -a your-app-name
      heroku config:set DB_URL=your_db_url -a your-app-name
    • Add optional variables as needed, such as GOOGLE_API_KEY, GROQ_API_KEY, etc.
  8. Deploy the Bot:

    • Push the code to Heroku:
      git push heroku main
    • Scale the dyno to run the bot:
      heroku ps:scale worker=1 -a your-app-name
  9. Verify Deployment:

    • Check the logs to ensure the bot is running:
      heroku logs --tail -a your-app-name
    • Interact with your bot on Telegram to confirm it’s operational.
  10. Managing FFmpeg on Heroku:

    • The FFmpeg buildpack automatically installs FFmpeg during deployment. No manual installation is required, unlike local setups.
    • If you encounter issues with FFmpeg, ensure the buildpack was added correctly and redeploy:
      git commit --allow-empty -m "Redeploy for FFmpeg"
      git push heroku main

Note: Heroku’s free tier has limitations, such as dyno hours and sleep periods. Consider upgrading to a paid plan for persistent bot availability. Ensure your .env or config.py settings are correctly mirrored in Heroku’s config vars.

Environment Variables βš™οΈ

Mandatory Vars To Connect The Bot To Telegram Server ⁉️

  1. API_ID - Obtain from my.telegram.org. πŸ”
  2. API_HASH - Obtain from my.telegram.org. πŸ”
  3. BOT_TOKEN - Create a bot via @BotFather. πŸ€–
  4. SESSION_STRING - Open @ItsSmartToolBot and use the /pyro command, then follow the instructions. πŸ“²
  5. OPENAI_API_KEY - Obtain from OpenAI API Console. 🧠
  6. MONGO_URL - MongoDB database URL for storing user and group Database, obtain from MongoDB. πŸ—„οΈ
  7. DATABASE_URL - Alternative MongoDB database URL For ChannelHelp, obtain from MongoDB. πŸ—„οΈ
  8. DB_URL - Additional MongoDB database URL For GroupHelp, obtain from MongoDB. πŸ—„οΈ

Recommended Optional Vars For The Core Utils🌟

  1. GOOGLE_API_KEY - For Google Gemini AI features, obtain from Google AI Studio. 🧠
  2. GROQ_API_KEY - For Groq AI models, obtain from Groq API Console. 🧠
  3. ADMIN_IDS - Comma-separated Telegram user IDs for admin access, obtain via @ItsSmartToolBot with /info. πŸ‘‘
  4. OWNER_IDS - Comma-separated Telegram user IDs for owner access, obtain via @ItsSmartToolBot with /info. πŸ‘‘

Optional Vars For The Utils ❄️

  1. SPOTIFY_CLIENT_ID - For Spotify features, obtain from Spotify Developer Dashboard. 🎢
  2. SPOTIFY_CLIENT_SECRET - For Spotify features, obtain from Spotify Developer Dashboard. 🎢
  3. LOCATIONIQ_API_KEY - For location-based features, obtain from LocationIQ. πŸ“
  4. IPINFO_API_TOKEN - For IP geolocation, obtain from IPinfo. 🌍
  5. NEWS_API_KEY - For news updates, obtain from the specified news API provider. πŸ“°
  6. BIN_KEY - For BIN lookup, obtain from HandyAPI. πŸ’³
  7. UPDATE_CHANNEL_URL - Telegram channel URL for bot updates. πŸ“’
  8. DEVELOPER_USER_ID - Telegram user ID of the bot developer, obtain via @ItsSmartToolBot with /info. πŸ‘¨β€πŸ’»
  9. PROFILE_ERROR_URL - Fallback image URL for users without a profile photo. πŸ–ΌοΈ
  10. OCR_WORKER_URL - Custom OCR API endpoint for text extraction. πŸ“„
  11. TEXT_API_URL - Custom text processing API endpoint. πŸ“
  12. IMAGE_API_URL - Custom image processing API endpoint. πŸ–ΌοΈ
  13. YT_COOKIES_PATH - Path to YouTube cookies file for media downloads (default: SmartUtilBot/cookies.txt). πŸͺ
  14. CC_SCRAPPER_LIMIT - Limit for credit card scraping (default: 5000). πŸ’³
  15. SUDO_CCSCR_LIMIT - Sudo user credit card scraping limit (default: 10000). πŸ’³
  16. MULTI_CCSCR_LIMIT - Multi-user credit card scraping limit (default: 2000). πŸ’³
  17. MAIL_SCR_LIMIT - Email scraping limit (default: 10000). πŸ“§
  18. SUDO_MAILSCR_LIMIT - Sudo user email scraping limit (default: 15000). πŸ“§
  19. CC_GEN_LIMIT - Credit card generation limit (default: 2000). πŸ’³
  20. MULTI_CCGEN_LIMIT - Multi-user credit card generation limit (default: 5000). πŸ’³
  21. DOMAIN_CHK_LIMIT - Domain check limit (default: 20). 🌐
  22. PROXY_CHECK_LIMIT - Proxy check limit (default: 20). πŸ›‘οΈ
  23. IMGAI_SIZE_LIMIT - Max image size for AI processing (default: 5MB). πŸ–ΌοΈ
  24. MAX_TXT_SIZE - Max text file size (default: 15MB). πŸ“
  25. MAX_VIDEO_SIZE - YouTube Downloader Max video file size (default: 2GB). πŸ“Ή
  26. VIDEO_RESOLUTION' - YouTube Downloader video resolution (default: 1280x720). πŸ“Ί
  27. COMMAND_PREFIX - Command prefixes (default: !|.|#|,|/).

Handling YouTube Download Errors with Cookies πŸͺ

To avoid errors related to YouTube sign-in requirements or bot protection, using a cookie file is highly recommended. Here's how to set it up:

Steps to Export and Use Cookies πŸ‘€

  1. Create a Dedicated Chrome Profile:

    • Create a new Chrome profile to manage your bot's cookies securely. πŸ–₯️
  2. Install a Cookie Management Extension:

    • Use a browser extension like Cookie Editor to manage and export cookies. πŸ”§
  3. Export Cookies from YouTube:

    • Log into YouTube using your new Chrome profile. πŸ“Ί
    • Use the cookie extension to export cookies in Netscape format. πŸ“„
  4. Save the Cookies File:

    • Save the exported cookies as ItsSmartToolBot.txt in the SmartUtilBot/ItsSmartToolBot.txt directory. πŸ“‚

Managing Cookies πŸ’‘

  • Cookie Expiry:
    • YouTube cookies may expire or become invalid. If you encounter download issues, export and replace the cookies file with a fresh one. πŸ”„
    • Don't Play Videos In Your Mobile Or PC Through The Account Which Cookie You Exported. Cause Such Activity Will Change Cookie's Values.
    • Don't Sign Out From The Gmail In Your PC Or Mobile From The Browser Of App From Which You Exported Cookies.
    • Don't Restart Or Turn On Off Your Bot Frequently To Refrain From COOKIE EXPIRY .
  • Cookie Depletion:
    • Avoid frequent bot restarts or excessive YouTube requests to prevent early cookie expiry. ⚠️
    • Monitor your bot's activity to ensure cookies remain valid. πŸ‘€

This setup ensures reliable access to YouTube content without encountering sign-in or bot protection errors. πŸš€

🌟 Handling Scrapper Utils Errors with SESSION_STRING πŸ’«

Avoid common user client errors by generating a fresh SESSION_STRING using ItsSmartToolBot 🌐

✨ Quick Steps to Generate SESSION_STRING

  1. πŸš€ Go to πŸ‘‰ @ItsSmartToolBot
  2. πŸ’¬ Send /pyro to start Pyrogram session generation
  3. πŸ†” Enter your API ID from my.telegram.org
  4. πŸ” Enter your API HASH
  5. πŸ“ž Input your phone number in international format (e.g., +880...) πŸ‡§πŸ‡©
  6. βœ… Send the OTP you receive (e.g., AB2 BC4 CD5 EF6 GH6) β€” the bot auto-extracts it as 24566
  7. πŸ’Ύ Check Saved Messages for your SESSION_STRING
  8. πŸ› οΈ Add it to your .env or config.py

❄️ Important Notice: Avoid Frequent Restarts ⚠️

Frequent restarts using user accounts can trigger Telegram's security system πŸ‘€

πŸ’₯ You Might Face:

  • 🚫 Forced logout of your account
  • ❌ 406 AUTH_KEY_DUPLICATED error
  • ⚠️ Temporary bans or session invalidation

⭐️ To Stay Safe:

  • Minimize restarts
  • Always use a fresh session if errors appear
  • Prefer bot accounts for heavy or persistent tasks

βœ… Pro Tips

  • Fresh sessions fix 90% of scraper issues
  • Never share your SESSION_STRING publicly
  • Use .env for secure config management

Contributing πŸ‘¨β€πŸ’»

Contributions are welcome! Please follow these steps:

  1. Fork the repository. 🍴
  2. Create a new branch (git checkout -b feature-branch). 🌿
  3. Commit your changes (git commit -m 'Add new feature'). πŸ’Ύ
  4. Push to the branch (git push origin feature-branch). πŸš€
  5. Open a Pull Request. πŸ“¬

Project Contributors

Main Author πŸ§‘β€πŸ’»

Contributing Author πŸ§‘β€πŸ’»

For inquiries or feedback, please feel free to reach out via Telegram.

Ethical Notice πŸ””

Ethics Reminder: Simply modifying a few lines of code does not constitute original authorship. When forking a project, always fork responsibly and give proper credit to the original creators.

About

Smart Util is the most complete bot designed to assist you with a wide array of tools. By @abirxdhack & @TheSmartDevs.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages