just-userbot

is a Python userbot built using the Pyrogram library. It's designed to enhance your Telegram experience with various features and commands. With this userbot, you can perform actions like simulating typing, controlling your PC, make speech from text, encode and decode Qrcodes, performing magic tricks, and even using ChatGPT for generating text.

📖 Table of Contents

• 📦 Features
• 📂 Userbot Structure
• 🚀 Getting Started
  • 🔧 Installation
  • 🤖 Running userbot
• 🤝 Contributing

📦 Features

• Prefixes are / and .

• All your message that starts with / will with typing effect, you need to try it :) ⌨️

• .commands: Get all commands

• .switch-typing: Switch on/off typing

• .music <song name>: Search and get any videos or songs from Youtube 🎥

• .gpt <prompt>: Utilize ChatGPT to generate text based on your prompt.

• .shutdown: Shutdown your PC with this command. No arguments required.

• .restart: Restart your PC using this command. No arguments needed. 🔄

• .cancel: Cancel any ongoing shutdown or restart process. No arguments required.

• .magic: Very beautiful effect with many hearts ❤️❤️❤️

• .qrcode <prompt>: Create a qrcode

• .decode (replied on photo-message): Decode any qrcode

• .gtts <prompt>: Make speech from text (language by default is ukrainian, plugins/TextToSpeech.py line 24)

📂 Userbot Structure

└── just-userbot/
    ├── misc/
    │   ├── __init__.py 
    │   └── filters.py
    ├── plugins/
    │   ├── TextToSpeech.py
    │   ├── ai.py
    │   ├── arts.py
    │   ├── calculator.py
    │   ├── commands.py
    │   ├── count.py
    │   ├── twitch.py
    │   ├── exec.py
    │   ├── heart.py
    │   ├── jokes.py
    │   ├── music.py
    │   ├── nekobin.py
    │   ├── note.py
    │   ├── parsemode.py
    │   ├── pc_control.py
    │   ├── processing.py
    │   ├── qrcode.py
    │   ├── typing.py
    │   └── variables.py
    ├── data.json
    ├── requirements.txt
    └── userbot.py

🚀 Getting Started

🔧 Installation

Start the bot in just-userbot folder only

1. Clone the repository:

   git clone https://github.com/your-username/just-userbot.git

2. Goto bot folder:

   cd just-userbot

3. Create a virtual envorietment:

   Windows:

     $ python -m venv venv

   Linux:

      $ python3 -m venv venv

4. Activate venv:

   Windows:

   $ .\venv\Scripts\activate

   Linux:

   $ source venv/bin/activate

5. Install all requirements:

   $ pip install -r requirements.py

6. Get api id and api hash of your telegram account:

   Official telegram's site for Developers

7. Get your pexels api key:

   Register and get api key

8. Create a virtual envorietment:

   Windows:

     $ echo . > .env

   Linux:

      $ touch .env

9. Write in file .env this data:

API_ID=<your api id>
API_HASH=<your api hash>

PEXELS_TOKEN=<your pexels api key>

🤖 Running userbot

Windows: sh $ python userbot.py Linux: sh $ python3 usebot.py

🤝 Contributing

Contributions are welcome! Here are several ways you can contribute:

• Submit Pull Requests: Review open PRs, and submit your own PRs.
• Join the Discussions: Share your insights, provide feedback, or ask questions.
• Report Issues: Submit bugs found or log feature requests for SHADOWREZI.

Contributing Guidelines

Click to expand

1. Fork the Repository: Start by forking the project repository to your GitHub account.
2. Clone Locally: Clone the forked repository to your local machine using a Git client.

   git clone <your-forked-repo-url>

3. Create a New Branch: Always work on a new branch, giving it a descriptive name.

   git checkout -b new-feature-x

4. Make Your Changes: Develop and test your changes locally.
5. Commit Your Changes: Commit with a clear and concise message describing your updates.

   git commit -m 'Implemented new feature x.'

6. Push to GitHub: Push the changes to your forked repository.

   git push origin new-feature-x

7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.

Once your PR is reviewed and approved, it will be merged into the main branch.