Converting sessions

If you're coming from another library, you might already have a session lying around.

mtcute provides a way to convert sessions from some other libraries to mtcute's format in @mtcute/convert package.

WARNING

Please, only use this to convert your own sessions.

DO NOT use this to convert stolen sessions or sessions you don't own. Please be a decent person.

Telethon v1.x

Telethon v2 seems to have removed the ability to export sessions, so it's currently not supported

import { convertFromTelethonSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromTelethonSession("..."))

import { convertFromTelethonSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromTelethonSession("..."))

Pyrogram

import { convertFromPyrogramSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromPyrogramSession("..."))

import { convertFromPyrogramSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromPyrogramSession("..."))

GramJS

import { convertFromGramjsSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromGramjsSession("..."))

import { convertFromGramjsSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromGramjsSession("..."))

Store session

In some version GramJS added support for storing session as a directory of files, and can be imported like so:

import { readGramjsStoreSession, convertFromGramjsSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
const session = await readGramjsStoreSession('/path/to/session')
await client.importSession(convertFromGramjsSession(session))

import { readGramjsStoreSession, convertFromGramjsSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
const session = await readGramjsStoreSession('/path/to/session')
await client.importSession(convertFromGramjsSession(session))

MTKruto

import { convertFromMtkrutoSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromMtkrutoSession("..."))

import { convertFromMtkrutoSession } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromMtkrutoSession("..."))

Telegram Desktop (tdata)

import { convertFromTdata } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromTdata({
    path: '/path/to/tdata',
    ignoreVersion: true // note: this might break
    // passcode: '123456' // if you have a passcode
}))

import { convertFromTdata } from '@mtcute/convert'

const client = new TelegramClient({ ... })
await client.importSession(convertFromTdata({
    path: '/path/to/tdata',
    ignoreVersion: true // note: this might break
    // passcode: '123456' // if you have a passcode
}))

Backwards

If you need to convert a session from mtcute to another library, you can use the convertTo* functions instead:

console.log(convertToTelethonSession(await client.exportSession()))

console.log(convertToTelethonSession(await client.exportSession()))

String-to-string

Once converted, you can use writeStringSession to convert the session to a string:

console.log(writeStringSession(convertFromTelethonSession("...")))

console.log(writeStringSession(convertFromTelethonSession("...")))

Manual

If your library is not supported, you can still convert the session manually.

In the most simple case, you'll only need auth_key and data center information:

const dc = {
    id: 2,
    ipAddress: '149.154.167.41',
    port: 443,
}

await client.importSession({
    version: 3,
    testMode: false,
    primaryDcs: { main: dc, media: dc },
    authKey: new Uint8Array([ /* ... */ ]),
})

const dc = {
    id: 2,
    ipAddress: '149.154.167.41',
    port: 443,
}

await client.importSession({
    version: 3,
    testMode: false,
    primaryDcs: { main: dc, media: dc },
    authKey: new Uint8Array([ /* ... */ ]),
})

Data center information

If you only know DC ID and not the IP address, you can use the mappings from @mtcute/convert to resolve it:

import { DC_MAPPING_PROD } from '@mtcute/convert'

const dc = DC_MAPPING_PROD[2]

import { DC_MAPPING_PROD } from '@mtcute/convert'

const dc = DC_MAPPING_PROD[2]

If you don't know such information at all, you can just always use the DC 2 (as above), and mtcute will handle the rest

User information

If you happen to know some information about the user logged in, it might help to provide it as well:

await client.importSession({
    ...,
    self: {
        userId: 777000,
        isBot: false,
        isPremium: false,
        usernames: [],
    }
})

await client.importSession({
    ...,
    self: {
        userId: 777000,
        isBot: false,
        isPremium: false,
        usernames: [],
    }
})

Converting sessions ​

Telethon v1.x ​

Pyrogram ​

GramJS ​

Store session ​

MTKruto ​

Telegram Desktop (tdata) ​

Backwards ​

String-to-string ​

Manual ​

Data center information ​

User information ​