EdBebop Userbot

Telegram's anime-fueled userbot by day, werewolf wrangler by night.

Docs coming soon »

Report Bug . Request Feature

Table Of Contents

• Table Of Contents
  • About The Project
  • Getting Started
    • Necessary Variables
    • Session String
    • Prerequisites
    • Installation
  • Deployment
    • Tutorial
    • One Click Options
  • Usage
  • Roadmap
  • Contributing
    • Creating A Pull Request
  • License
  • Authors
  • Credits

About The Project

There are many great telegram userbots available on GitHub, however, I didn't find one that really suit the needs of anime fan and a werewolf addict so I tailored Ultroid into EdBebop your one and only anime-powered social fight club moderator, wrangling both werewolf addicts and otakus alike.

Here are some things that make it different:

• 📋️ Auto-pin capability for werewolf telegram bots
• 🔍️ Search MyAnimeList and see info on new animes
• 🎉 Hope to make your life easier by adding features you can automate since you shouldn't be suffering with such mundane things like a peasant
• 🛠️ Working on short hand for werewolf commmands and auto join

Of course, no one userbot will serve all your needs since your needs may be different. So I'll be adding more in the near future just add an issue if you want something new or ask on our group. You may also help by adding your own changes by forking this repo and creating a pull request or opening an issue.

Getting Started

To get a working version of the userbot on your machine or VPS here is how you can set up this project. The first step is to get the necessary variables this variables are crucial to get a working userbot.

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
  • MONGO_URI - Get it from mongodb.
• For SQLDB
  • DATABASE_URL- Get it from elephantsql.

Session String

Different ways to get your SESSION:

• 
• 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

---

Prerequisites

Here is the list of things you need to install to get a running copy on your local machine and how to install them.

• python

E.g for arch linux you would do something like this

sudo pacman -S python

for details on how to install python for every platform read this official python installation guide.

Installation

First make sure you get your Necessary Variables.

Clone the repository and enter the directory

git clone https://github.com/NehemiahAklil/EdBebop.git
cd Ultroid

Create a python virtual environment
Using official python venv package (recommended)

python3 -m venv venv

or

virtualenv -p /usr/bin/python3 venv

Activate virtual enviroment

`. ./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

Deployment

Tutorial

• Full Tutorial

• Tutorial to get Redis URL and password - here.

One Click Options

After you get the Necessary Variables pick the site you would like to deploy with and deploy your userbot.

Don't know where to host your userbot see our hosting guide.

Usage

Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.

For more examples, please refer to the Documentation

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
• Please make sure you check your spelling and grammar.
• Create individual PR for each suggestion.
• Please also read through the Code Of Conduct before posting your first idea as well.

Creating A Pull Request

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Authors

• Boy Wonder - Software Artsian - Boy Wonder - Added werewolf module

Credits

• TeamUltroid-Devs
• Lonami for Telethon.
• MarshalX for PyTgCalls.
• ShaanCoding for README

Powered by WegegtaTech.