Pyrogram Userbot
A Telegram Userbot based on Pyrogram
This repository contains the source code of a Telegram Userbot and the instructions for running a copy yourself. Beside its main purpose, the bot is featuring Pyrogram Asyncio and Smart Plugins; feel free to explore the source code to learn more about these topics.
I assume you will read this whole README.md file before continuing.
Development in progress.
Requirements
You're gonna need to get the following programs and services either installed on your server or signed up for. You must do all. It is a cardinal sin if you don't.
-
virtualenvinstalled so that the packages don't interfere with other system packages. -
MongoDB on your server or a free server from MongoDB Atlas. (I recommend Atlas as I used it during development with no issues.)
-
carbon-now-cli on your server too generate code images for the carbon.py module. I use this CLI tool cause I don't know and couldn't get selenium and chromedriver to work nicely on my server/code. I'll be nice and even give you the command to install this. I assume you already have NPM installed.
Windows: npm install -g carbon-now-cli Linux: sudo npm install -g carbon-now-cli --unsafe-perm=true --allow-root MacOS: I assume almost the same as linux ¯\_(ツ)_/¯
Installation and Deployment
The way I deploy
git clone https://github.com/athphane/userbot.git
cd userbot
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python -m userbot
Spotify integration
To get the Spotify commands working on the Userbot, you need to get a CLIENT_ID and CLIENT_SECRET form the Spotify Developer Portal and add them into your userbot.ini file.
On the Spotify developer portal, make sure to set your application Redirect URI to 'http://localhost:8888/callback'.
Now is a good time Then go ahead and run the command python spotify.py in the projects root directory.
This will create a file called .cache-yourusername. You need to transfer this file to the project root of the server that will be running your userbot. This is a one time setup.
Developing
To add extra modules to the bot, simply add the code into userbot/plugins. Each file that is added to the plugins directory should have the following code at a minimum.
from pyrogram import Message, Filters
from userbot import UserBot
@UserBot.on_message(Filters.command('sample', ['.']))
async def module_name(bot: UserBot, message: Message):
await message.edit(
"This is a sample module"
)
This example is only for Pyrogram on_message events.
Known issues
.restartcommand do not work on Termux as psutils is not supported on Android.
CTRL+C, rungit pullandpython -m userbotto update bot on termux.
Credits, and Thanks to
-
Dan for his Pyrogram Library
-
Colin Shark for his PyroBot which helped with most of the useful functions used.
-
The people at MyPaperPlane for their Telegram-UserBot that gave a ton of ideas on how and what modules to include in this userbot.
-
Baivaru for the ton of help that got me this far into making this repo.
Made with love from the Maldives
![[BUG] config file is no longer supported in Pyrogram](https://avatars.githubusercontent.com/u/18140039?v=4)
164 Nov 12, 2022
1 Nov 11, 2021
9 Oct 17, 2022
44 Nov 12, 2022
1 Dec 23, 2021
22 Dec 25, 2022
17 Oct 29, 2022
6 Apr 29, 2022
1 Feb 12, 2022
28 Nov 12, 2022
1 Nov 28, 2021
70 Jan 2, 2023
6 Feb 12, 2022
13 Oct 21, 2022
11 Oct 21, 2022
6 Jun 26, 2022
3 Oct 28, 2022
3 Oct 23, 2021