danog/MadelineProto

Features

• MTProto Implementations - Implements the MTProto protocol for direct Telegram API communication without Bot API intermediaries.
• Telegram Clients - Connects to Telegram's API using the MTProto protocol, supporting both user accounts and bots.
• Telegram Bot Frameworks - Provides a full SDK for building Telegram bots with event-driven handlers and filters.
• Messaging - Marks messages as read in Telegram chats, a core messaging capability.
• Media Downloads - Saves Telegram media to a specified directory with progress tracking and cancellation support.
• Content Stream Manipulations - Provides readable byte streams of Telegram file contents with offset support for progressive consumption.
• PHP Attribute Filters - Uses PHP attributes to apply additional conditions like sender or command text.
• API Call Batching - Queues multiple concurrent Telegram API calls into a single container for efficient batch processing.
• Session State Serializers - Saves and restores the entire Telegram client session to disk for persistent authentication.
• Authentication-as-a-Service - Authenticates using a bot token without requiring a phone number or code.
• Event Handler Method Markers - Designates methods as entry points for processing specific Telegram events via attributes.
• Phone Number Authentications - Logs in using a phone number and verification code to act as a regular Telegram user.
• Bot Command Interfaces - Processes slash commands in chats by extracting the command name and description.
• Direct Message Replies - Replies directly to existing messages, preserving conversation threads.
• Telegram Chat Sending - Uploads and sends document files to Telegram chats with metadata.
• User and Chat Broadcasting - Ships a broadcast system that sends messages to all peers while managing platform rate limits.
• Message Pinning - Pins messages to the top of Telegram chats with notification options.
• Telegram Message Sending - Sends and receives messages via Telegram's MTProto protocol using either a bot token or user phone number.
• Message Editing and Deletion - Edits the text of a message with optional markup or reply markup.
• Client Configuration Settings - Adjusts storage backends, logging, and other operational parameters for the Telegram client.
• Progress-Tracking File Downloads - Downloads media files to specified directories with progress tracking and cancellation support.
• Telegram File Downloads - Saves Telegram files to a specified file path on the filesystem with progress tracking.
• Telegram File Downloads - Downloads Telegram files to a local directory with progress tracking and cancellation support.
• Telegram File Downloads - Downloads files up to 4GB from Telegram's servers to local paths with progress tracking and cancellation.
• Telegram Media Downloads - Saves Telegram media files to a specified file path with progress tracking and cancellation.
• Telegram File Transfers - Transfers files to and from Telegram's servers with support for local files, remote URLs, and bot API file IDs.
• Telegram API Integrations - Provides a programmatic interface for interacting with the Telegram API using the MTProto protocol.
• Event Handlers - Processes real-time Telegram updates including messages, calls, and queries through event handler classes.
• Update Polling - Polls the Telegram API for new updates with configurable long-polling timeouts.
• Userbot Frameworks - Automates personal Telegram user accounts for messaging, broadcasting, and content management.
• Client Event Loop Starters - Provides the entry point for running a Telegram client's event loop with error handling and restart logic.
• Asynchronous PHP Development - Built on Amp v3 fiber-based concurrency for non-blocking Telegram API interactions.
• Bot Authentication Strategies - Authenticates as a Telegram bot using a token to access the MTProto API directly.
• Dual Bot and User Authentications - Logs in using either a bot token or a phone number to access Telegram.
• Event-Driven Frameworks - Implements a single-threaded event loop framework for concurrent Telegram bots in PHP.
• Fiber-Based Concurrent Execution - Provides fiber-based cooperative multitasking for non-blocking async operations within a single-threaded event loop.
• Bot Client Starters - Provides the entry point for starting a Telegram bot client with token authentication and event handling.
• Long-Lived Bot Processes - Keeps a bot process running continuously to react to Telegram events in real time.
• Attribute-Based Filter Registries - Processes Telegram updates through a modular plugin system with attribute-based filters and concurrent handler execution.
• Dual Bot and User Authentications - Logs in using a phone number and code or a bot token to match official client flow.
• Phone Number Authentications - Logs in using a phone number and verification code like the official Telegram apps.
• Telegram Update Filters - Processes Telegram updates through a stable attribute-based filter system instead of legacy methods.
• File Streaming - Provides readable byte streams of Telegram file contents for progressive consumption with offset support.
• Authenticated User Retrieval - Retrieves uncached information about the currently authenticated user.
• File Upload - Provides file upload capabilities with progress tracking for sending media to Telegram chats.
• Parallel File Transfers - Transfers multiple Telegram files simultaneously without blocking the main event loop.
• Event Handler Plugin Creators - Provides a base plugin class for extending Telegram update handling with session data persistence.
• Photo Uploaders - Supports photo uploads with progress reporting for sending images to Telegram conversations.
• Concurrent Account Sessions - Handles updates from several Telegram accounts in parallel, each with its own event handler instance.
• Channel Invitations - Invites users to Telegram channels and supergroups through the MTProto API.
• Telegram Media Downloader - Downloads audio and other media files from Telegram with progress tracking.
• Callback-Based File Streamers - Streams Telegram file contents in chunks to a user-defined callback for custom processing.
• Message Deletion Scripts - Removes messages from Telegram chats with optional revocation for all participants.
• Targeted Message Deletion - Provides targeted message deletion by unique identifiers for removing specific chat messages.
• Case-Insensitive Command Filters - Filters incoming Telegram messages by command text while ignoring letter casing.
• Direction Filters - Provides direction-based filters to process only incoming messages, ignoring outgoing ones.
• Edit Status Filters - Provides filters to process only edited messages in incoming Telegram updates.
• Media Type Filters - Provides attribute-based filters to process only messages containing specific media types like photos or videos.
• Direct Download Link Generators - Generates direct download links for Telegram files up to 4GB in size.
• Telegram Download Links - Generates download URLs for Telegram media files up to 4GB in size.
• Asynchronous ORM Mappings - Maps handler properties to database rows using an asynchronous ORM for persistent state.
• Handler Property Mappings - Ships an async ORM that maps handler properties to database rows for persistent state across restarts.
• Automatic Property Persistence - Saves handler property values to a database or session file automatically across restarts.
• Current User Identifiers - Retrieves details about the currently logged-in user or bot.
• External State Stores - Stores internal session and entity data in MySQL, MariaDB, Postgres, or Redis for persistence.
• Session Database Backends - Connects the bot to MariaDB, PostgreSQL, or Redis for persistent session and entity data storage.
• Membership Change Detectors - Fires events when participants join, leave, are banned, or change admin status in channels.
• Styled Text to HTML Converters - Converts styled message text with formatting entities into HTML for display.
• Fiber-Based Background Tasks - Launches coroutines or callables to run concurrently without blocking the main event flow.
• Green Thread Forking - Starts background operations that run independently of the main flow using green threads.
• VoIP Call Recorders - Captures incoming audio streams from Telegram VoIP calls and writes them to local files.
• Bulk Senders - Provides a bulk message sending feature that distributes messages to all reachable peers with scheduling options.
• Recipient Filtering - Provides recipient filtering to restrict broadcast messages to a subset of peers.
• Callback Query Responders - Responds to inline button clicks with popups, URL openings, or cached results.
• Phone Verification Code Logins - Finishes authentication by providing the SMS login code during phone-based login.
• Two-Factor Account Logins - Finishes authentication by providing the second-factor password during login.
• Participant Management - Retrieves information about specific participants in Telegram channels or supergroups.
• Reply Detection Utilities - Detects whether a Telegram message is a reply to another message and retrieves the original.
• Reply Retrieval Utilities - Retrieves the message that a Telegram message replies to, with optional type filtering.
• Discussion Thread Routing - Retrieves the copy of a message sent to a linked discussion group.
• Telegram Download Links - Generates direct download URLs for any Telegram file up to 4GB in size.
• In-App Message Translators - Translates message text or captions using Telegram's built-in translation.
• Command-Based Message Filters - Filters incoming Telegram messages to only process those starting with a recognized command.
• Group Chat Filters - Keeps only updates that originate from group chats.
• Telegram Webhook Receivers - Receives Telegram updates through an HTTP webhook endpoint for use from non-PHP languages like JavaScript.
• Inline Query Processors - Processes incoming inline queries from users, providing query text and user ID for result navigation.
• Join Request Processing - Indicates when a user requests to join or has joined a discussion group.
• Message Content Filtering - Provides message content filtering to allow only messages whose text matches a specified string.
• Case-Insensitive Message Filters - Filters incoming Telegram messages to only those matching a given string, ignoring case.
• Prefix Filters - Ships prefix-based message filters that ignore case for matching incoming Telegram messages.
• Suffix Filters - Ships suffix-based message filters that ignore case for matching incoming Telegram messages.
• Regex Message Filters - Filters messages and button queries using regular expression patterns.
• Comment Reply Filters - Provides filters to process only messages from @replies in Telegram comment threads.
• Prefix Filters - Provides prefix-based message filters to process only messages starting with a specified string.
• Reply Status Filters - Provides reply status filters to process only messages that are replies to other messages.
• Suffix Filters - Provides suffix-based message filters to process only messages ending with a specified string.
• Message Reactions - Removes reactions from Telegram messages programmatically.
• Message TTL Setters - Sets automatic deletion time-to-live for all messages in a chat.
• Chat Action Indicators - Broadcasts typing and other real-time activity indicators to Telegram chat participants.
• Audio Message Constructions - Sends audio files to Telegram chats with title, performer, and thumbnail.
• Topic Message Listeners - Provides topic-based message listeners to process only messages from forum topics.
• Sender Type Filters - Provides filters to process only messages sent by bot accounts, ignoring human-sent messages.
• Message Deletion Detectors - Fires events when messages are removed from supergroups or channels, providing deleted message identifiers.
• Traffic Routing Proxies - Routes all Telegram API traffic through one or more proxy servers, automatically selecting the best option.
• Command Request Filtering - Filters incoming messages to only process those starting with a specific command and optional bot username.
• Telegram Message Entity Parsing - Parses HTML strings into Telegram message formatting entities for structured message handling.
• Automatic Message Entity Parsers - Controls automatic HTML and Markdown parsing of message text for Telegram formatting.
• Markdown to Telegram Entity Parsers - Parses Markdown strings into Telegram message formatting entities for structured messaging.
• Call Discarders - Ends active Telegram voice calls with optional rating and comment submission.
• Telegram Call Clients - Answers an incoming Telegram voice call programmatically.
• Call Audio Streamers - Streams audio files and URLs into active Telegram VoIP calls for playback during conversations.
• Telegram Call Initiators - Initiates Telegram VoIP calls to users by ID, username, or peer with full protocol support.
• Call Lifecycle Managers - Manages Telegram voice calls lifecycle including initiation, audio streaming, recording, and hold music playback.
• MTProto Proxy Clients - Supports MTProxy, SOCKS5, and HTTP proxies out of the box, handling transport and secret negotiation automatically.
• Sticker Messages - Sends sticker files to Telegram chats with optional emoji.
• Bulk Forwarders - Ships a bulk message forwarding capability that sends messages to all reachable peers with configurable options.
• Message Forwarding Utilities - Forwards messages between Telegram chats with options to drop the original author.
• Forwarded Sender Filters - Provides filters to process only messages forwarded from a specific sender in Telegram.
• Custom Proxy Frameworks - Implements custom proxy protocols using the stream API with TLS support for Telegram traffic routing.
• Proxy Traffic Management - Routes Telegram traffic through MTProxy, HTTP, SOCKS5, or other proxy types for connectivity.
• User Action Status Trackers - Monitors and reports real-time user actions like typing or recording in Telegram chats.
• Green Thread Forking - Executes functions in background green threads asynchronously without blocking the main flow.
• Interactive Authentication Flows - Guides users through a console or web-based login flow to choose authentication method.
• Secret Chat Message Senders - Sends encrypted messages within established secret chat sessions.
• Secret Chat Acceptors - Accepts incoming secret chat requests to establish end-to-end encrypted conversations.
• Secret Chat Managers - Establishes and maintains end-to-end encrypted secret chats with Perfect Forward Secrecy for Telegram.
• Multi-Account Session Management - Runs multiple Telegram accounts simultaneously with persistent session storage.
• Sender Identity Filtering - Provides sender identity filtering to restrict message processing to specified users or groups.
• Secret Chat Acceptances - Automatically accepts or declines incoming Telegram secret chat requests programmatically.
• Secret Chat Initiators - Initiates private encrypted conversations via secret chat requests.
• Secret Chat Status Queries - Queries the current active state of a Telegram secret chat programmatically.
• Application Information - Sets application metadata such as API ID and hash to authenticate with Telegram.
• Broadcast Custom Actions - Ships a custom action execution system that runs user-defined logic against every peer with rate limiting.
• Periodic Loop Executions - Executes code repeatedly at adjustable intervals with support for dynamic changes.
• Peer Broadcasters - Executes a user-defined action for every peer the bot can reach, with progress tracking and cancellation.
• Path Request Rate Limiters - Calculates maximum safe call frequency by measuring flood wait triggers and pacing requests accordingly.
• Asynchronous Operation Cancellation - Stops running async tasks by passing cancellation tokens for cooperative task termination.
• Broadcast Process Management - Provides broadcast process management to monitor and cancel background broadcasting tasks.
• Telegram Proxy Routers - Routes Telegram traffic through MTProxy, SOCKS5, or HTTP proxies with automatic selection and transport negotiation.
• Chat Message Retrieval - Provides API-driven retrieval of message metadata and HTML representations from Telegram chats.
• Message View Tracking - Increments the view counter for messages in Telegram channels.
• Channel Joiners - Joins Telegram channels or chats via invite links or usernames using the MTProto API.
• Task Schedulers - Runs handler methods at fixed intervals with millisecond precision and stop or restart capability.
• Bot Keyboard Builders - Accepts both MTProto and Bot API reply markup objects for constructing interactive keyboards.
• Inline Button Clickers - Provides programmatic access to click inline buttons in Telegram messages by position or properties.
• Automatic Message Forwarding - Forwards existing messages to all peers of a bot with automatic rate limit management.
• Custom Filter Attributes - Extends the built-in filter system by implementing a custom attribute.
• Photo and Video Uploads - Uploads video files to Telegram chats with progress tracking and percentage reporting.
• Telegram Message Entity to HTML Converters - Converts Telegram message formatting entities into HTML for web display.
• Typing Indicators - Sends typing indicators to Telegram chats to show user activity.
• File Download Utilities - Streams Telegram files to the browser with HEAD request support for direct downloads.
• Raw Update Handlers - Processes low-level Telegram API updates as arrays using named handler methods.
• Bot Frameworks - Async PHP client for the MTProto protocol.

Star history