NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules · #1062 by repository stars
Last release 1 years ago
23 Sep 2025
Release timing varies
gaps range from 1 weeks to 12 months
Nearly every release is documented
notes for 34 of 35 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
74 releases · first in 2018
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.
Updated Telegram API to layer 204.
caption_in_message manually.Dropped support for Python 3.9.
Updated Telegram API to layer 169.
ignore_unbridged_group_chat was enabled.Removed support for MSC2716 backfilling.
add-contact and delete-contact commands.Security: Updated Pillow to 10.0.1.
as_tokens.
See docs for more info.Nothing published for this version
Added option to delete megolm sessions that were received before the automatic ratcheting options were introduced.
bridge.filter.users config option not being read correctly.Added fallback messages for calls and premium gifts.
sync_direct_chats is enabled.Added allow_contact_info config option to specify whether personal names and avatars for other users should be bridged.
allow_contact_info config option to specify whether personal names
and avatars for other users should be bridged.
telegram_file table.Added built-in custom emoji packs to allow reacting with any standard unicode emoji from Matrix (note that only premium users can use custom emojis).
Support for custom emojis in reactions.
mxc://
URIs, so client support is required to render them properly.MAUTRIX_DIRECT_STARTUP environment variable. Additionally, it will
refuse to run as a non-root user if that variable is not set (and print an
error message suggesting to either set the variable or use a custom command).login_shared_secret_map.ChatParticipantsForbidden is handled properly when syncing non-supergroup
info.N.B. This release requires a homeserver with Matrix v1.1 support, which bumps up the minimum homeserver versions to Synapse 1.54 and Dendrite 0.8.7. M
N.B. This release requires a homeserver with Matrix v1.1 support, which bumps up the minimum homeserver versions to Synapse 1.54 and Dendrite 0.8.7. Minimum Conduit version remains at 0.4.0.
fi.mau.double_puppet_source key from the content.encryption -> verification_levels config options can be used to
make the bridge require encrypted messages to come from cross-signed
devices, with trust-on-first-use validation of the cross-signing master
key.encryption -> require option can be used to make the bridge ignore
any unencrypted messages.encryption -> rotation
config./login/send_code provisioning API to return a proper error when the
phone number is not registered on Telegram.
plaintext_highlights config option (the code using it was already
removed in v0.11.0).ephemeral_events and disabling
sync_with_custom_puppets in the config, then regenerating the registration
file.N.B. This release drops support for old homeservers which don't support the new /v3 API endpoints. Synapse 1.48+, Dendrite 0.6.5+ and Conduit 0.4.0+ a
N.B. This release drops support for old homeservers which don't support the
new /v3 API endpoints. Synapse 1.48+, Dendrite 0.6.5+ and Conduit 0.4.0+ are
supported. Legacy r0 API support can be temporarily re-enabled with pip install mautrix==0.16.0.
However, this option will not be available in future releases.
list-invite-links command to list invite links in a chat.t.me/c/chatid/messageid
style links with a link to the bridged Matrix event (in addition to the
previously supported t.me/username/messageid links).\n instead
of converting them to <br/>.max_document_size option. The bridge will now fetch the max size
automatically using the media repo config endpoint.msgtype field in sticker events sent to Matrix.filename in the file log handler to a
path that is writable, then add "file" back to logging.root.handlers.!tg bridge throwing error if the parameter is not an integer!tg bridge failing if the command had been previously run with an
incorrectly prefixed chat ID (e.g. !tg bridge -1234567 followed by
!tg bridge -1001234567).bridge_matrix_leave config option not actually being used correctly.N.B. This will be the last release to support Python 3.7. Future versions will require Python 3.8 or higher. In general, the mautrix bridges will only
N.B. This will be the last release to support Python 3.7. Future versions will require Python 3.8 or higher. In general, the mautrix bridges will only support the lowest Python version in the latest Debian or Ubuntu LTS.
t.me/+code style invite links in !tg join.private_chat_profile_meta config option.community_id config option.!tg create.Added support for message reactions.
Switched from SQLAlchemy to asyncpg/aiosqlite.
sqlite optional dependency.alembic, then upgrade to v0.11.0 (or higher).Added extensions when bridging unnamed files from Telegram.
max_initial_member_sync work for non-supergroups too
(thanks to @tadzik in #680).N.B. Docker images have moved from dock.mau.dev/tulir/mautrix-telegram to dock.mau.dev/mautrix/telegram. New versions are only available at the new pa
N.B. Docker images have moved from dock.mau.dev/tulir/mautrix-telegram
to dock.mau.dev/mautrix/telegram. New versions are only available at the new
path.
geo_uri.AuthKeyDuplicatedError is now handled properly instead of making the user
get stuck.public_portals setting not being respected on room creation.Added options to bridge archive, pin and mute status from Telegram to Matrix.
--uses=<amount> and
--expire=<delta> flags for !tg invite-link.Nothing published for this version
Fixed cleaning unidentified rooms.
bridge_connected metric is now only set for users who are logged in.!tg caption (broken in rc1).bridge_.python -m mautrix_telegram has been the official way to start
the bridge for a long time.m.direct list when using double puppeting.login_shared_secret, it uses
MSC2778 instead (requires Synapse 1.21 or higher).Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed deleting messages from Matrix.
Note: this release is not on PyPI, as the only changes were a mautrix-python update (v0.5.8) and a fix to the Docker image.
Fixed starting bridge for the first time failing due to not registering the bridge bot.
Updated to mautrix-python 0.5.0 and matrix-nio 0.12.0.
private_chat_portal_meta option. This is implicitly enabled when
encryption is enabled, it was only added as an option for instances with
encryption disabled.ChatForbidden when syncing chats.sync_direct_chats option creating non-working portals./tmp.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed enabling double puppeting causing saved messages to become unusable.
ignore_own_incoming_events was enabled.Pre-release Pre-release Compare
Pre-release
Pre-release
Compare
Fixed missing responses in logout provisioning API.
ignore_own_incoming_events was set to true.!tg config set to throw an error.Nothing published for this version
Nothing published for this version
Fixed handling of Matrix m.emote events.
m.emote events.version command output in CI docker builds not showing the correct
git commit hash.ChatForbidden when syncing chats that was causing the sync to fail.m.emote formatting of logged in users.%.!tg set-pl with no parameters.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed vulnerability in event handling.
FileIdInvalidError in file transfers that could disrupt
syncs.retry_delay and other TelegramClient constructor fields.NoneType is not iterable exception when logging out
(thanks to [@turt2live] in #315).m.relates_to is null.batch_alter_table for adding columns to have less
warnings with SQLite.pinging without being logged in.Nothing published for this version
Nothing published for this version
Fixed null m.relates_to's that break Synapse 0.99.5.
m.relates_to's that break Synapse 0.99.5.Fixed Python 3.5 compatibility.
Replaced rawgit with cdnjs in public website as rawgit is deprecated.
username for setting Telegram username.sync-state for updating Matrix room state cache.matrix-ping for checking Matrix login status (thanks to @krombel in #271).clear-db-cache for clearing internal database caches.reload-user for reloading and reconnecting a Telegram user.session for listing and terminating other Telegram sessions.login to allow admins to log in for other users.ensure_started is now only called for logged in users, which should improve
performance for large instances.(Telegram) suffix) are now stripped
when mentioning Telegram users with no username.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed kicking Telegram puppets from Matrix.
body.<pre> tags for multiline code even if
said code was in the telegram equivalent of inline code tags.@None if you don't
have a username./connect of the provisioning API
(thanks to [@turt2live] in #223).Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →