danog/MadelineProto
Async PHP client API for the telegram MTProto protocol observed · 2026-08-28
Health v2 · maintenance only
92/100
- Activity 98
- Release rhythm 80
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 3
- age_days: 3723
- days_rel: 135
- days_push: 16
- n_releases_24m: 42
Adoption not part of the score
3501 stars · 885 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
MadelineProto is an async PHP library implementing the Telegram MTProto protocol, allowing full client functionality (user or bot login) without the official Bot API. It supports messaging, file upload/download, secret chats, VoIP calls, proxies, inline bots, and Prometheus metrics.
Use cases
- build a telegram bot in php without the bot api
- create a userbot to automate my telegram account
- download telegram stories and files programmatically
- make and receive telegram phone calls from code
- broadcast messages to all users of a telegram bot
- implement secret chats and encrypted messaging
- run a long-running telegram event handler bot in docker
When to choose
- you need full Telegram client capabilities (user login, secret chats, calls) beyond the Bot API
- you want to build bots or userbots in PHP with async event handling
- you need file upload/download, broadcast, or proxy support in a Telegram client
When to avoid
- you only need simple bot features and prefer the official Bot API's simplicity
- your stack is not PHP
- you cannot accept the risk of Telegram account bans associated with userbots
Facets
library · maturity active
http-client websocket sdk chatbot file-upload audio-processing proxy monitoring messaging-platforms developer-tools apis php cli telegram mtproto userbot async amphp voip secret-chats tdlib-alternative bot-api-alternative automation linux macos docker web-server
10 sources
- readme: https://github.com/danog/MadelineProto · fetched 2026-08-28 · a3fb93b32a7a
- homepage: https://docs.madelineproto.xyz · fetched 2026-08-29 · 4859eb255ecf
- site_page: https://docs.madelineproto.xyz/docs/CREATING_A_CLIENT.html · fetched 2026-08-29 · 4a95df5b0356
- site_page: https://docs.madelineproto.xyz/docs/LOGIN.html · fetched 2026-08-29 · 54aa984123a4
- site_page: https://docs.madelineproto.xyz/docs/FEATURES.html · fetched 2026-08-29 · 7877336b0feb
- site_page: https://docs.madelineproto.xyz/docs/REQUIREMENTS.html · fetched 2026-08-29 · 65bcd6d64777
- site_page: https://docs.madelineproto.xyz/docs/DOCKER.html · fetched 2026-08-29 · 0f29c1ee2c50
- site_page: https://docs.madelineproto.xyz/docs/METRICS.html · fetched 2026-08-29 · bbb24b3f08bb
- site_page: https://docs.madelineproto.xyz/docs/INSTALLATION.html · fetched 2026-08-29 · 6bc976c66b1a
- site_page: https://docs.madelineproto.xyz/docs/BROADCAST.html · fetched 2026-08-29 · db0d8b68993c
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| danog/MadelineProto | main | 92 |
For agents
markdown · JSON · MCP: product_card(name="danog/MadelineProto")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem