/Ultroid

Advanced Multi-Featured Telegram UserBot, Built in Python Using Telethon lib.

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

TeamUltroid Logo

Ultroid - UserBot

A stable pluggable Telegram userbot + Voice & Video Call music bot, based on Telethon.

Stars Forks Size
Python CodeFactor Maintenance Docker Pulls
Open Source Love svg2 Contributors PRs Welcome License
Sparkline

Deploy

Documentation

Documentation

Tutorial

  • Full Tutorial - Full Tutorial

  • Tutorial to get Redis URL and password - here.


Deploy to Heroku

Get the Necessary Variables and then click the button below!

Deploy

Deploy Locally

Local Deploy - Easy Method

  • Linux - wget -O locals.py https://git.io/JY9UM && python3 locals.py
  • Windows - cd desktop ; wget https://git.io/JY9UM -o locals.py ; python locals.py
  • Termux - wget -O locals.py https://git.io/JY9UM && python locals.py

Local Deploy - Traditional Method

  • Get your Necessary Variables
  • Clone the repository:
    git clone https://github.com/TeamUltroid/Ultroid.git
  • Go to the cloned folder:
    cd Ultroid
  • Create a virtual env:
    virtualenv -p /usr/bin/python3 venv . ./venv/bin/activate
  • Install the requirements:
    pip(3) install -U -r re*/st*/optional-requirements.txt pip(3) install -U -r requirements.txt
  • Generate your SESSION:
    • For Linux users: bash sessiongen or wget -O session.py https://git.io/JY9JI && python3 session.py
    • For Termux users: wget -O session.py https://git.io/JY9JI && python session.py
    • For Windows Users: cd desktop ; wget https://git.io/JY9JI -o ultroid.py ; python ultroid.py
  • Fill your details in a .env file, as given in .env.sample. (You can either edit and rename the file or make a new file named .env.)
  • Run the bot:
    • Linux Users: bash startup
    • Windows Users: python(3) -m pyUltroid

Ultroid CLI

Ultroid CLI is a command-line interface for deploying Ultroid.

  • Installing -
    Run the following code on a terminal, with curl installed.
    ver=$(curl https://raw.githubusercontent.com/BLUE-DEVIL1134/UltroidCli/main/version.txt) && curl -L -o ultroid https://github.com/BLUE-DEVIL1134/UltroidCli/releases/download/$ver/ultroid.exe OR Go to UltroidCli and install the version release from the Github Releases. Add the executable to your system path as specified in the Readme.

  • Documentation - Take a look at the docs for more detailed information.


Necessary Variables

  • SESSION - SessionString for your accounts login session. Get it from here

One of the following database:

  • For Redis (tutorial here)
    • REDIS_URI - Redis endpoint URL, from redislabs.
    • REDIS_PASSWORD - Redis endpoint Password, from redislabs.
  • For MONGODB
  • For SQLDB

Session String

Different ways to get your SESSION:

  • Run on Repl.it
  • Linux : wget -O session.py https://git.io/JY9JI && python3 session.py
  • PowerShell : cd desktop ; wget https://git.io/JY9JI ; python ultroid.py
  • Termux : wget -O session.py https://git.io/JY9JI && python session.py
  • TelegramBot : @SessionGeneratorBot

License

License
Ultroid is licensed under GNU Affero General Public License v3 or later.


Credits

Made with 💕 by @TeamUltroid.