Skip to content

Releases: mautrix/whatsapp

v25.10

16 Oct 11:32

Choose a tag to compare

Release post: https://mau.fi/blog/2025-10-mautrix-release/

  • Switched to calendar versioning.
  • Added support for bridging event edits.
  • Fixed backfill creating incorrect disappearing timer change notices.
  • Fixed previous messages not being marked as read when sending a new message.
  • Fixed incoming call notices with LID addressing going into different DM room.

v0.12.5

16 Sep 12:55

Choose a tag to compare

Release post: https://mau.fi/blog/2025-09-mautrix-release/

Another reminder about the @lid migration WhatsApp is doing that was mentioned in the v0.12.0, v0.12.2 and v0.12.3 release notes: the registration.yaml file must have .+ (or .*) instead of [0-9]+ in the user ID regex, e.g. @whatsapp_.+:example\.com. If you set up the bridge prior to v0.5.0 and do not fix your registration file, group chats will gradually stop working as WhatsApp migrates them to use LIDs. See the troubleshooting page for more details.

  • Removed legacy provisioning API and database legacy migration. Upgrading directly from versions prior to v0.11.0 is not supported.
    • If you've been using the bridge since before v0.11.0 and have prevented the bridge from writing to the config, you must either update the config manually or allow the bridge to update it for you before upgrading to this release (i.e. run v0.12.4 once with config writing allowed).
  • Added support for changing group name/topic/avatar from Matrix (thanks to @Petersmit27 in #834).
  • Added RedactedPhone placeholder for displayname templates. This allows community announcement groups (where you can't see participants phone numbers) to have better names than random numbers.
  • Added support for com.beeper.disappearing_timer state event, which stores the disappearing setting of chats and allows changing the setting from Matrix.
  • Added lottieconverter to Docker images to enable converting animated stickers from WhatsApp.
  • Added support for creating WhatsApp groups.
  • Fixed sent PNGs not being rendered on WhatsApp iOS.

v0.12.4

16 Aug 12:33

Choose a tag to compare

Release post: https://mau.fi/blog/2025-08-mautrix-release/

  • Deprecated legacy provisioning API. The /_matrix/provision/v1 endpoints will be deleted in the next release.
  • Bumped minimum Go version to 1.24.
  • Added support for bridging HD dual uploads from WhatsApp into edits on Matrix.
  • Added better placeholders for pin and keep messages from WhatsApp.
  • Fixed bridging animated webp stickers to WhatsApp.
    • Note that non-square stickers may appear corrupted on native clients. The bridge will not automatically add padding to animated stickers like it does for static ones.
  • Fixed avatar changes not reflecting on both the LID and phone number ghost of a given user in certain cases.
  • Fixed first message after group LID migration still using the phone number ghost.
  • Fixed bot messages in DMs being split into another portal room.
  • Fixed new group members not having a phone number name in some cases.

v0.12.3

16 Jul 11:09

Choose a tag to compare

Release post: https://mau.fi/blog/2025-07-mautrix-release/

  • Further improved support for @lid users.
    • N.B. As mentioned in the v0.12.0 and v0.12.2 release notes, old registration files may have [0-9]+ in the users regex. You must change it to .+, as the new lid identifiers are bridged as lid-<number> instead of just <phone number>.
  • Added automatic conversion when sending quicktime/mov videos to WhatsApp.
  • Fixed disappearing message timer not automatically fixing itself in some cases.
  • Fixed call notices being sent to DM portal even if the call was in a group.

v0.12.2

16 Jun 18:14

Choose a tag to compare

Release post: https://mau.fi/blog/2025-06-mautrix-release/

  • Improved support for @lid users.
    • N.B. As mentioned in the v0.12.0 release, old registration files may have [0-9]+ in the users regex. You must change it to .+, as the new lid identifiers are bridged as lid-<number> instead of just <phone number>.
  • Updated Docker image to Alpine 3.22.
  • Fixed network errors on first connect not triggering automatic reconnect.
  • Fixed animated sticker zips not being extracted when using direct media.

v0.12.1

16 May 05:37

Choose a tag to compare

Release post: https://mau.fi/blog/2025-05-mautrix-release/

  • Added prefix to identify forwarded messages on WhatsApp.
  • Updated mime type of unconverted animated stickers to video/lottie+json which is now registered with IANA.
  • Changed relogin command to not require entering phone number twice when using phone code login.
  • Fixed outgoing messages being rejected if they replied to a fake message generated by the bridge.
  • Fixed backfilling messages in existing portals after relogining.

v0.12.0

16 Apr 11:34

Choose a tag to compare

Release post: https://mau.fi/blog/2025-04-mautrix-release/

  • Migrated Signal session store to use new @lid identifiers to support future chats that don't expose phone numbers.
    • N.B. Old registration files may have [0-9]+ in the users regex. You must change it to .+, as the new lid identifiers are bridged as lid-<number> instead of just <phone number>.
  • Added fallbacks for various business message types.
  • Added support for bridging invites, kicks and leaves in groups.
  • Re-added invite-link, join and sync commands for groups.
  • Fixed bridging chats with Meta AI.

v0.11.4

16 Mar 16:45

Choose a tag to compare

Release post: https://mau.fi/blog/2025-03-mautrix-release/

  • Fixed edits being bridged multiple times if a single chat had multiple logged-in Matrix users.
  • Fixed bridging some types of business messages that were supposed to be supported (there are still some unsupported types).

v0.11.3

16 Feb 16:16

Choose a tag to compare

Release post: https://mau.fi/blog/2025-02-mautrix-release/

  • Bumped minimum Go version to 1.23.
  • Added support for signaling supported features to clients using the com.beeper.room_features state event.
  • Fixed converting voice message duration and waveform.
  • Fixed padding in stickers sent to WhatsApp sometimes being the wrong color.

v0.11.2

16 Dec 16:57

Choose a tag to compare

Release post: https://mau.fi/blog/2024-12-mautrix-release/

  • Added better notice when view-once messages are unavailable.
  • Fixed some cases of @lid user IDs being bridged incorrectly.
  • Fixed starting chats by inviting Matrix ghosts.
  • Updated Docker image to Alpine 3.21.