# danog/MadelineProto

Async PHP client API for the telegram MTProto protocol

Repository: https://github.com/danog/MadelineProto
Canonical: https://ross.abutalabs.com/products/madelineproto
Homepage: https://docs.madelineproto.xyz
Language: PHP
License: AGPL-3.0
License Family: copyleft
Topics: mtproto, bot, php, madelineproto, telegram, easy, telegram-api, secret-chats, proxy, voip, amphp, stickers, inline-bots, calls, async, mtproto-api, hacktoberfest, tdlib, tdlib-php
Last push: 2026-08-17T11:47:33+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 80, longevity 100
- inputs: {"age_days": 3723, "days_push": 16, "days_rel": 135, "gap_med": 3, "n_releases_24m": 42}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3501, forks 885 (observed 2026-08-28T04:08:07.541174+00:00)

## What it is
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
- artifact type: library
- maturity: active
- function: http-client, websocket, sdk, chatbot, file-upload, audio-processing, proxy, monitoring
- domain: messaging-platforms, developer-tools, apis
- platform: php, cli
- tags: telegram, mtproto, userbot, async, amphp, voip, secret-chats, tdlib-alternative, bot-api-alternative, automation, linux, macos, docker, web-server

## Member repositories
- danog/MadelineProto (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:07.541174+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:47.884134+00:00, confidence not recorded.
  - readme: https://github.com/danog/MadelineProto (fetched 2026-08-28T04:08:07.541174+00:00, sha a3fb93b32a7a)
  - homepage: https://docs.madelineproto.xyz (fetched 2026-08-29T09:29:52.285184+00:00, sha 4859eb255ecf)
  - site_page: https://docs.madelineproto.xyz/docs/CREATING_A_CLIENT.html (fetched 2026-08-29T09:29:52.290556+00:00, sha 4a95df5b0356)
  - site_page: https://docs.madelineproto.xyz/docs/LOGIN.html (fetched 2026-08-29T09:29:52.292368+00:00, sha 54aa984123a4)
  - site_page: https://docs.madelineproto.xyz/docs/FEATURES.html (fetched 2026-08-29T09:29:52.294519+00:00, sha 7877336b0feb)
  - site_page: https://docs.madelineproto.xyz/docs/REQUIREMENTS.html (fetched 2026-08-29T09:29:52.296214+00:00, sha 65bcd6d64777)
  - site_page: https://docs.madelineproto.xyz/docs/DOCKER.html (fetched 2026-08-29T09:29:52.298342+00:00, sha 0f29c1ee2c50)
  - site_page: https://docs.madelineproto.xyz/docs/METRICS.html (fetched 2026-08-29T09:29:52.300310+00:00, sha bbb24b3f08bb)
  - site_page: https://docs.madelineproto.xyz/docs/INSTALLATION.html (fetched 2026-08-29T09:29:52.302121+00:00, sha 6bc976c66b1a)
  - site_page: https://docs.madelineproto.xyz/docs/BROADCAST.html (fetched 2026-08-29T09:29:52.303819+00:00, sha db0d8b68993c)
- Data as of 2026-08-30T08:39:29.467469+00:00.