- #include <std/disclaimer.h>
- /
- Your Telegram account may get banned.
- I am not responsible for any improper use of this bot
- This bot is intended for the purpose of having fun with memes
- as well as efficiently managing groups
- You ended up spamming groups, getting reported left and right,
- and the Telegram Team deleted your account?
- And then you pointed your fingers at me for getting yourself reported?
- I will laugh at you.
- /

A modular telegram Python UserBot running on python3 with an sqlalchemy database.

Started up as a simple bot, which helps with deleting messages and other stuffs when I didn't possess a smartphone(selecting each message indeed difficult) with a ton of meme features kanged from SkittBot, it has evolved, becoming extremely modular and simple to use.

If you just want to stay in the loop about new features or announcements you can join the news channel.

If you find any bugs or have any suggestions then don't hesitate to contact me in my support group.

• This README is not guaranteed to always be up to date, refer to the support channel for the latest informations.

Carfully read this entire guide before cloning so you don't end up getting stuck. When followed properly you'll end up with your userbot up and running after following it.

Get your api-id (called API_KEY in this bot) and API_HASH from my.telegram.org.

Optional: Create an empty group, add Marie, or any forks, get the group id, copy it and set it as your LOGGER (in case you want logging).

If you wish to use a database-dependent module (eg: locks, notes, userinfo, users, filters, welcomes), you'll need to have a database installed on your system. I use postgres, so I recommend using it for optimal compatibility.

In the case of postgres, this is how you would set up a the database on a debian/ubuntu system. Other distributions may vary.

• install postgresql:

sudo apt-get update && sudo apt-get install postgresql

• change to the postgres user:

sudo su - postgres

• create a new database user (change YOUR_USER appropriately):

createuser -P -s -e YOUR_USER

This will be followed by you needing to input your password.

• create a new database table:

createdb -O YOUR_USER YOUR_DB_NAME

Change YOUR_USER and YOUR_DB_NAME appropriately.

• finally:

psql YOUR_DB_NAME -h YOUR_HOST YOUR_USER

This will allow you to connect to your database via your terminal. By default, YOUR_HOST should be 127.0.0.1:5432.

You should now be able to build your database URI. This will be:

sqldbtype://username:pw@hostname:port/db_name

Replace sqldbtype with whichever db youre using (eg postgres, mysql, sqllite, etc) repeat for your username, password, hostname (localhost?), port (5432?), and db name.

There are two possible ways of configuring your bot: a config.env file, or ENV variables.

The prefered version is to use a config.env file, as it makes it easier to see all your settings grouped together. This file should be placed in the topmost part of the repo. This is where your API KEYS will be loaded from, as well as your database URI (if you're using a database), and most of your other settings.

An example config.env file could be:

    API_KEY=123456
    BUILD_CHOICE="bleeding"
    API_HASH='4588acb1863ead924119c885dfffba2'
    LOGGER_GROUP=-1001200493567
    LOGGER=True    #Incase you want to turn off logging, put this to false
    TRT_ENABLE=False
    PM_AUTO_BAN=True
    CONSOLE_LOGGER_VERBOSE=True
    SCREEN_SHOT_LAYER_ACCESS_KEY="get from screenshot layer website google it "
    OPEN_WEATHER_MAP_APPID="get it from openweather site"    
    DB_URI="postgres://userbot:mypass@localhost:5432/userbot"

If you can't have a config.env file, or you missed to type something on config.env but then pushed it up, it is also possible to use environment variables.

• Installation of these is a must:

pkg install clang python-dev postgresql-dev libcrypt-dev libffi-dev openssl-dev libxml2-dev libxslt-dev libjpeg-turbo-dev ndk-sysroot make

pip3 install python-dotenv

• Installation of git:

pkg install git

• Installation of Heroku-CLI [Google it if you face problems]

npm i -g heroku

• Cloning the repo:

git clone https://github.com/baalajimaestro/Telegram-UserBot.git

• Move to the directory:

cd Telegram-UserBot

• Install required files:

pip3 install -r requirements.txt

• Start it up:

python3 -m userbot

• nitamarcel

Without him this idea of Termux set up would have never come into existence.

1. Make sure to generate a session file, by running app.py on your local pc before deploying it on Heroku.

• Make sure you followed the instruction to setup the config file/ENV variables.
• If you need Database Commands, provision a heroku postgres instance.
• Push you bot along with config.env and userbot.session with the heroku cli, you need git add -f to add both of them.
• Deploy.

Once you've setup your database and your configuration (see below) is complete, simply run:

python3 -m userbot

. stands for any random special character like *,&,^,% , it is made for the ease of the user

• .approve: approve DMing
• .afk: Sets you as AFK
• just send a message Anywhere To Remove afk: Sets you as not AFK, and gives you brief list if who messaged you while you were away
• .chatid: show chat id
• .userid: show user id
• .getqr: encrypt QRCode
• .screencapture
• .weather
• .updatebleeding
• .updatestable

• .filter trigger response
• .stop trigger
• .rmfilters
• .filters

• .saved
• .clear
• .save
• .rmnotes

• .purge
• .purgeme
• .delmsg
• .editme
• .sd

• .img
• .google
• .wiki
• .ud
• .tts
• .trt: translate text
• .lang: change language

• .promote: promote user
• .ban: ban user
• .mute: mute user(doesnt use TG API mute)
• .unmute: unmute user

• .gmute: Global Mute a User.
• .ungmute: Ungmute a User!.

• .pip
• .pingme: pings server
• .paste: paste code in hastebin
• .log: Save the message in your logs
• .speed: speed test
• .hash
• .random
• .alive: check if bot is running
• .restart: restart the bot
• .shutdown: shutdown the bot
• .shutdown: REALLY shutdown the bot
• .support: get support
• .supportchannel: get support
• .repo: link to this repo
• .sysd
• .botversion
• .term: execute terminal commands

• :/
• -_-
• .cp
• .vapor
• .str
• .zal
• .owo
• .react
• .shg: * Shrugs *
• .runs: random message
• .disable runs
• .enable runs
• .mock
• .clap

Creating a module has been simplified as much as possible - but do not hesitate to suggest further simplification.

All that is needed is that your .py file be in the modules folder.

To add commands, make sure to import the the primary bot via

from userbot import bot.

and

telethon's important stuff via

from telethon import events

You can then add commands wrapping them under

@bot.on(events.NewMessage(outgoing=True,pattern=""))
async def some_function(e):
     Whatever here.

You can also set outgoing to incoming incase, you wanna make that command to parse the incoming message.

The command pattern will be regex. Hope you know it, else feel free to hop on here

Use asynchronous functions, and await the functions.

Should you need assistance with telethon library check out their documentation or get support from them

I would like to thank people who assisted me throughout this project:

• @YouTwitFace
• @TheDevXen
• @Skittles9823
• @deletescape
• @songotenks69
• @Ovenoboyo
• SphericalKat
• nitamarcel

and many more people who aren't mentioned here.

Found Bugs? Create an issue on the issue tracker, or post it in the support group.