README

SessionBridge : Pure-PHP library to convert and bridge Telegram sessions between popular client formats ( Telethon , Pyrogram , Tdata , MadelineProto ) and LiveProto ( LP )

🔥 SessionBridge focuses on compatibility, reliability, and realistic production use. It provides a unified API and CLI to read, validate, convert, and export session / auth data across different implementations of Telegram's MTProto ecosystem

Key features

• Convert sessions between Telethon , Pyrogram , MadelineProto , Tdata ( Telegram Desktop ) and LiveProto ( LP ) formats
• High-fidelity mapping of session fields where possible ( dc_id , ip , port , auth_key )
• Simple, chainable PHP API and a practical command-line interface ( CLI )

Note : SessionBridge is a translator / bridge between session file formats ( or text of session ) it does not reimplement MTProto or perform network login for you. Use a proper client library ( MadelineProto , LiveProto , Telethon , Pyrogram ) to perform active logins and connection flows

Installation

Install via Composer :

composer require taknone/sessionbridge

Or include directly in your project autoload

Quick start

PHP

<?php

require_once 'vendor/autoload.php';

use function Tak\SessionBridge\from_madelineproto_string;

use function Tak\SessionBridge\to_liveproto_sqlite;

$sessions = from_madelineproto_string('session.madeline');

foreach($sessions as $session){
	var_dump(to_liveproto_sqlite($session));
}

?>

CLI

• convert telethon.session file to LiveProto file

php vendor/bin/sessionbridge --from telethon-sqlite --to liveproto-sqlite --session telethon.session

Supported formats

• Telethon ( .session SQLite / String )
• Pyrogram ( .session SQLite / String )
• MadelineProto ( PHP session arrays / serialized files )
• Tdata ( Telegram Desktop profile folder , extract relevant files )
• LiveProto ( LP ) ( first-class citizen , SessionBridge is linked and can export / import LP files )

If you need support for additional session types open an issue or contribute an adapter

License

SessionBridge is released under the AGPLv3

Contact

If you need help, open an issue or discuss changes via pull requests. For sensitive security issues, use the repository's security contact

• Email : MRTakNone@gmail.com
• Telegram : https://TakNone.t.me

🎊 Happy bridging !