DS

Pyrogram userbot for delay spam in multiple chats

Warning

Your Telegram account may get banned if this userbot is misused. We are not responsible for any spam, violations, or account restrictions.

Use it at your own risk and review the Telegram API Terms.

Table of Contents

• Requirements
• Quick Start
  • Clone Repository
    • String Session
    • Config
• Deployments
  • Docker Compose
  • Locally
• Usage
• Update
• Supports
• Contributing
• License

Requirements

• Python 3.14+
• Linux (Debian/Ubuntu)
• Telegram API_ID and API_HASH from API development tools

Quick Start

Follow these steps to set up and run DS on your system.

Clone Repository

git clone https://github.com/kastaid/ds.git
cd ds

String Session

Generate STRING_SESSION by running python3 strgen.py, or directly:

python3 -c "import urllib.request as r;exec(r.urlopen('https://gist.githubusercontent.com/illvart/05a462d25ef1a99278201c5ee6b5ff14/raw').read())"

or using Docker:

docker run --rm -it python:3.14-alpine python3 -c "import urllib.request as r;exec(r.urlopen('https://gist.githubusercontent.com/illvart/05a462d25ef1a99278201c5ee6b5ff14/raw').read())"

Config

Create a .env file in the main directory and fill it with the example from example.env.

Deployments

Choose your preferred deployment method below.

Docker Compose

Deploy using Docker Compose for easy containerized deployment.

git pull && \
  docker compose up -d --build && \
  docker compose logs -f

Locally

Run DS locally on your machine or server (e.g., on Termux).

We recommend using uv for faster and more reliable Python package management.

Production

Using uv:

uv pip install -r requirements.txt
python3 -m ds

Using pip:

pip3 install -r requirements.txt
python3 -m ds

Development

Using uv:

uv pip install -r requirements.txt
uv pip install -r requirements-dev.txt
python3 -m run --watch

Using pip:

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

More commands: run python3 -m run -h.

Usage

Once successfully deployed, test your DS by sending ping in any chat.

Start DS

Usage:

ds [delay] [count] [forward/fwd (reply only)] [text/reply] [to=chat]
ds1 [delay] [count] [forward/fwd (reply only)] [text/reply] [to=chat]

Examples:

ds 5 10 ok
ds1 9 5 cool

You can run up to 10 independent DS tasks (ds - ds9).

Send to a specific chat:

ds 5 10 ok to=@username
ds1 9 5 cool to=-1001234567890

Reply to a message and use forward or fwd to forward it instead of copying:

ds 5 10 forward
ds 5 10 fwd

Cancel

Cancel DS in a specific chat:

dscancel [to=chat]
ds1cancel [to=chat]

Stop

Stop DS tasks in all chats:

dsstop
ds1stop

Clear

Stop and clear all DS tasks:

dsclear

For more details, see delayspam.py.

Update

DS supports updating through Git:

git pull

If you updated from an older version and experience errors, fix your local repo with:

git fetch origin && git reset --hard origin/main

This is NOT required for fresh installs.

Supports

If you’re enjoying it or want to support development, feel free to donate. Thank you! ❤️

Contributing

Want to contribute? Read the Contributing.

License

Released under the MIT License.