README

High-Performance Telegram Broadcast Manager for MadelineProto. Manage broadcasts efficiently: send messages, media albums, pin/unpin messages, control broadcasts in real-time, and track live progress with advanced features.

🌟 Features

🚀 High-Performance Broadcasts Send messages concurrently to thousands of users, groups, or channels with configurable concurrency.
⏸ Pause / Resume / Cancel Broadcasts Control ongoing broadcasts in real-time without restarting.
📌 Pin & Unpin Messages
- Pin the last broadcasted message automatically.
- Unpin all messages for all subscribers.
🧹 Delete Last Broadcast
- Remove previously sent messages from all users.
- Retries failed deletions and handles Telegram API limits automatically.
♻️ Delete All Broadcasts
- Remove previously all sent messages from all users.
- Retries failed deletions and handles Telegram API limits automatically.
📊 Live Progress Tracking
- Visual progress bars
- Messages per second (TPS)
- Sent, failed, and pending counts
- Paused/cancelled indicators
🖼 Media Albums Support
- Send multiple images/documents in a single broadcast using sendMultiMedia.
- Supports captions and message entities.
💾 Saving & Reusing Albums
Save albums to a JSON file for reuse in future broadcasts.
Use album-bot as an example to store album files locally.
🛡 FLOOD_WAIT Handling & Retries Automatically respects Telegram rate limits and retries failed messages.
🔘 Inline Buttons / Reply Markup
- Include interactive buttons for links, commands, or actions.

📁 Repository Structure

BroadcastManager/
├── src/
│   └── BroadcastManager.php
├── data/
│   └── .gitkeep
├── composer.json
├── README.md
├── LICENSE
└── CHANGELOG.md

💻 Requirements

⚡ Installation

composer require wizardloop/broadcastmanager

Include autoload:

require 'vendor/autoload.php';

🚀 Usage Example

use BroadcastTool\BroadcastManager;

$manager = new BroadcastManager($api);

$manager->broadcastWithProgress(
    allUsers: $users,
    messages: $messages,
    chatId: $adminChatId,
    filterType: 'users',
    pin: true,
    concurrency: 25
);

⏸ Control Broadcasts

$manager->pause();
$manager->resume();
$manager->cancel();

Check state:

if ($manager->isPaused()) echo "Paused";
if ($manager->isCancelled()) echo "Cancelled";
print_r($manager->progress());

🧹 Delete Last Broadcast

$manager->deleteLastBroadcastForAll(
    allUsers: $users,
    chatId: $adminChatId,
    concurrency: 20
);

♻️ Delete All Broadcast

$manager->deleteAllBroadcastsForAll(
    allUsers: $users,
    chatId: $adminChatId,
    concurrency: 20
);

📊 Get Last Broadcast Data

$manager->lastBroadcastData();

📌 Pin / Unpin Messages

Pin last broadcast automatically:

$manager->broadcastWithProgress(..., pin: true);

Unpin all messages:

$manager->unpinAllMessagesForAll(...);

🔘 Inline Buttons & Reply Markup

$message = [
    'message' => "Click a button below:",
    'buttons' => [
        [['text' => "Visit Website", 'url' => "https://example.com"]],
        [['text' => "Start", 'callback_data' => "start_action"]]
    ]
];

⚙️ Advanced Options

Concurrency – Number of parallel workers.
Filter Types – 'users', 'groups', 'channels', 'all'
Album Handling – JSON-based albums with multiple media files.
Retries & Delays – Automatic retries with backoff.
Progress Tracking – Real-time broadcast stats with progress().

🤝 Contributing

Fork repo
Create branch: git checkout -b feature/my-feature
Commit changes: git commit -m "Add feature"
Push branch: git push origin feature/my-feature
Open Pull Request

📄 License

GNU AGPL-3.0 — see LICENSE.

📝 Changelog

See [CHANGELOG.md] for updates.

✅ Pro Tips

Use pin: true to pin important broadcasts.
Include buttons for interactive messages.
Adjust concurrency for optimal performance.
Use pause/resume/cancel for safe broadcast control.

wizardloop / broadcastmanager

Maintainers

Details