getter

Get and put users (scraping) to the target group/channel efficiently, correctly and safety.

#include <std/disclaimer.h>
/*
*   Your Telegram account may get banned.
*   We are not responsible for any improper use of this userbot.
*   This userbot is specific for scraping members with some helpfull commands.
*
*   If you ended up spamming groups, getting reported left and right,
*   and you ended up in being fight with Telegram
*   and at the end Telegram Team deleted your account. DON'T BLAME US.
*
*   No personal support will be provided / We won't spoon feed you.
*   If you need help ask in our support group 
*   and we or our friends will try to help you.
*/

Table of Contents

Details

• Requirements
  • STRING_SESSION
  • Config
• Deployments
  • Docker Compose
    • Full version
    • Lite version
  • Locally
• Example Plugin
• Supports
• Credits and Thanks
• Contributing
• License

Requirements

• Python 3.11.x
• Linux (Recommend Debian/Ubuntu)
• Telegram API_ID and API_HASH from API development tools

STRING_SESSION

Generate STRING_SESSION using @strgen_bot or run locally python3 strgen.py

Config

Create and save .env file at main directory and fill with the example config file at example.env.

Deployments

Deploy getter to your server or locally.

Docker Compose

Deploy to your server using docker compose.

Full version

git pull && \
  docker compose -f full-compose.yml up --detach --build --force-recreate && \
  docker compose -f full-compose.yml logs -f

Lite version

git pull && \
  docker compose -f lite-compose.yml up --detach --build --force-recreate && \
  docker compose -f lite-compose.yml logs -f

Locally

Run getter as locally eg: termux

Production

pip3 install -r requirements.txt
python3 -m getter

Development

pip3 install -r requirements.txt
pip3 install -r requirements-dev.txt
python3 -m run --watch

More commands python3 -m run -h

Example Plugin

Clone the repo, then create and save plugin at ./getter/plugins/plugin_name.py.

This Example Works Everywhere. (e.g. Groups, Personal Chats)

from . import kasta_cmd
@kasta_cmd(pattern="hi")
async def _(event):
    await event.eor("Hello **World**.")

This Example Works Only In Personal Chats.

from . import kasta_cmd
@kasta_cmd(pattern="hi", func=lambda e: e.is_private)
async def _(event):
    await event.eor("Hello **World**.")

This Example Works Only In Channels.

from . import kasta_cmd
@kasta_cmd(pattern="hi", func=lambda e: e.is_channel and e.chat.broadcast)
async def _(event):
    await event.eor("Hello **World**.")

This Example Works Only In Groups.

from . import kasta_cmd
@kasta_cmd(pattern="hi", func=lambda e: e.is_group)
async def _(event):
    await event.eor("Hello **World**.")

This Example Works Only In Groups or Channels.

from . import kasta_cmd
@kasta_cmd(pattern="hi", func=lambda e: not e.is_private)
async def _(event):
    await event.eor("Hello **World**.")

?? Supports

This project is open source and free to use under the license. However, if you are using this project and happy with it or just want to encourage me to continue creating stuff please donate!

Credits and Thanks

• LonamiWebs - Telethon
• TeamUltroid - Team Ultroid
• userbotindo - Userbot Indonesia Community
• illvart - Core Developer

and everyone ??

Contributing

If you would like to help out with some code, check the details.

License

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.