Erwan Leboucher a3ad7ebe4c chore: prepare release 1.22.0 (#1840)
> **Preview the next release on [dev.sable.moe](https://dev.sable.moe)**

> [!IMPORTANT]
> Merging this PR will create a new release.

## Features

* Add support for description lists by @Steffo99 in #2098
* Allow swiping away in-app notifications on mobile by @blueberrymuffin3
in #1863
* Add a configurable gif provider (Tenor, Giphy or Klipy) and send gifs
through the media proxy by @eleboucher in #1918
* Add a customizable Global shortcut to show or hide the app window by
@cwyptt in #2040
* Add a built-in UnifiedPush distributor so Android push works without
Google Play Services or a separate distributor app, support MSC4174 so
the homeserver can deliver web push directly, and decrypt push previews
through the Rust crypto engine. by @eleboucher in #1607
* Show the gif and sticker composer buttons by default, keeping only
emoji while typing on mobile. by @eleboucher in #1862
* Publish the Flatpak for aarch64 in addition to x86_64. by @eleboucher
in #2084
* Add a setting to show all timestamps, including on grouped messages
from the same sender by @cwyptt in #1942
* Update MSC4461 (Persona) support to v3 by @blueberrymuffin3 in #1923

## Fixes

* Fix restoring from key backup failing entirely when a single backed-up
key could not be read; the rest of the keys are now restored. by
@eleboucher in #2001
* Fix calls disconnecting on servers that use sticky memberships: the
call now has permission to publish them, and sticky memberships also
reach clients that sync with sliding sync. by @eleboucher in #2066
* Fix device names being reset every time the client is opened. Also
makes the device rename field set the default name when left empty. by
@RoootTheFox in #1939
* Keep verified devices verified: stop crypto-store conflicts between
sessions, and restore cross-signing trust when unlocking backup with a
recovery key. by @eleboucher in #2105
* Fix a crash when emoji autocomplete results reappear while typing. by
@eleboucher in #1886
* Fix failure toasts showing the green success style with a checkmark:
errors such as "Unable to mark this room as read" now use the error
colour and a warning icon. by @eleboucher in #2005
* Fix the Flatpak app failing to launch after a previous run, where a
leftover CEF cache lock was mistaken for a running instance. by
@eleboucher in #1989
* Fix the forum room "Event Timeline" developer entry bouncing straight
back to the forum view. by @eleboucher in #1857
* Fix forum rooms opening in the normal chat view and improve forum post
and thread navigation. by @7w1 in #1839
* Fix avatars and media flickering, disappearing after backgrounding or
token rotation, or failing to download, in the desktop and mobile apps.
by @eleboucher in #2105
* Fix mobile keyboard handling: emote backspace flicker, Android
viewport height, duplicated mention pills, and a keyboard stuck over the
room list, timeline images, or composer sheets. by @eleboucher in #2105
* Make push notifications and background sync more reliable when the app
is closed or in the background. by @eleboucher in #2105
* Fix a sent message coming back in the composer, and stop undo
restoring cleared content. by @eleboucher in #1862
* Fix unexpected sign-outs and preserve saved accounts when signing in
again. by @eleboucher in #2053
* Fix sending the first message after startup taking up to 40 seconds in
encrypted rooms: outgoing crypto requests and key backup checks now
coalesce instead of queueing one full run per caller, and repeated
undecryptable events no longer re-request the key backup version from
the server. by @eleboucher in #1998
* Fix being unable to back out of a space preview opened by address, and
give Tauri webview back/swipe somewhere to land on deep-linked launches.
by @eleboucher in #1868
* Fix the login page crashing with "Invalid URL" on Android WebView
below 130 by @eleboucher in #1924
* Keep the new messages divider visible when opening a room with unread
messages. by @eleboucher in #1906
* Merge image-pack updates from legacy clients and mirror edits or
deletions to active legacy pack state keys. by @7w1 in #1975
* Reimplement responsive composer layout by @Septicity in #1865

## Documentation

* Update to disclosure of AI generated code by @dozro in #885
2026-09-17 22:18:31 +02:00
2026-09-17 20:17:55 +00:00
2026-08-28 21:42:46 +03:00
2026-08-11 20:47:28 +02:00
2026-07-26 14:51:16 -05:00
2026-09-17 20:17:55 +00:00
2026-03-05 22:34:11 -06:00
2026-07-24 19:45:52 -05:00
2026-07-18 18:56:17 +03:00
2026-09-17 20:17:55 +00:00
2026-07-30 14:21:10 -05:00
2026-08-28 21:42:46 +03:00
2026-09-13 20:21:56 +00:00
2023-02-24 17:28:04 +05:30
2026-07-19 01:06:28 +02:00
2026-09-17 20:17:55 +00:00
2026-07-24 19:42:44 -05:00
2026-05-13 12:42:00 -05:00
2026-07-31 21:02:03 +02:00

Sable

A Matrix client built to enhance the user experience with quality-of-life features, cosmetics, utilities, and sheer usability. See the changelog.

Soon to be replaced desktop apps can be downloaded here. They auto-update by pulling the website.

Join our matrix space here to discuss features, issues, or meowing.

Forked from Cinny.

Getting started

The stable web app is available at app.sable.moe and tracks the latest GitHub release. Nightly builds are available at dev.sable.moe and from the nightly GitHub release.

You can also download our desktop app for Windows and Linux from releases. Release artifacts include build attestations. AppImage and Windows installations update automatically; .deb, .rpm, and AUR installations update through their package manager.

Desktop (Linux / macOS / Windows)

Download   Flathub

On macOS, via our Homebrew tap:

brew install --cask SableClient/sable/sable

The fully qualified name matters: since Homebrew 6.0.0 non-official taps need explicit trust, and installing this way trusts just this one cask. brew tap followed by a short-name install now fails unless you also run brew trust.

On Linux, nightly builds have their own Flatpak remote, rebuilt from dev every night:

flatpak remote-add --if-not-exists sable-nightly https://sableclient.github.io/Sable/sable-nightly.flatpakrepo
flatpak install sable-nightly moe.sable.client.Nightly

It installs alongside the stable Flathub build under a separate application ID. Built by the build-nightly-flatpak and publish-nightly-flatpak jobs in tauri-build.yml.

Android (Obtainium)

Android APKs are published to every release, and Obtainium keeps them updated straight from GitHub. Each release also ships an obtainium.json app config. Use it for the nightly channel, where prereleases and date-based version tracking have to be enabled to follow the rolling nightly tag.

Stable

Add to Obtainium   App config   Download APK

Nightly

Add to Obtainium   App config   Download APK

Setup & install

  1. Install Obtainium.
  2. Tap Add to Obtainium above. Stable opens the Add App page prefilled with https://github.com/SableClient/Sable; nightly opens an import prompt, since it carries the prerelease and version-tracking settings the rolling nightly tag needs.
  3. Or download the obtainium.json for either channel and import it with Import/Export → Import from file.

Android builds are produced by the android job in tauri-build.yml, and the config by the obtainium job in the same workflow.

Relevant variables and switching between Nightly and Stable

Relevant variable differences between Nightly and Stable:

  • Include prereleases - true for Nightly, false for Stable
  • Fallback to older releases - false for Nightly, true for Stable
  • Use latest asset upload as release date - true for Nightly, false for Stable (this is due to Nightly builds being uploaded to one release instead of creating new ones)
  • Use release date as version string (pseudo-version) - true for Nightly, false for Stable (this is due to Nightly builds being uploaded to one release instead of creating new ones)

iOS (AltStore / SideStore)

Sable iOS builds are distributed as unsigned IPAs through AltStore and SideStore. Each release publishes both the IPA and an altstore-source.json manifest — stable builds to the latest GitHub release, nightly builds to the nightly GitHub release.

Stable Source

Add to AltStore   Add to SideStore   Direct URL

Nightly Source

Add to AltStore   Add to SideStore   Direct URL

Setup & install

  1. Set up AltStore Classic or SideStore on your device.
  2. Add the Sable source (tap a button above), or add it manually:
    • AltStore (stable): altstore://source?url=https://github.com/SableClient/Sable/releases/latest/download/altstore-source.json
    • SideStore (stable): sidestore://source?url=https://github.com/SableClient/Sable/releases/latest/download/altstore-source.json
    • AltStore (nightly): altstore://source?url=https://github.com/SableClient/Sable/releases/download/nightly/altstore-source.json
    • SideStore (nightly): sidestore://source?url=https://github.com/SableClient/Sable/releases/download/nightly/altstore-source.json
  3. Install Sable from the source. The IPA is unsigned; AltStore/SideStore re-sign it with your personal development certificate at install time, so apps refresh every 7 days (the standard free-account limitation).

iOS builds are produced by the ios job in tauri-build.yml and track the same dev/v* triggers as desktop builds.

Self-hosting

You have a few options for self hosting, you can:

  1. Run the prebuilt docker container.
  2. Deploy on a site like GitLab Pages. Jae has a guide here.
  3. Build it yourself.

Docker

Prebuilt images are published to ghcr.io/sableclient/sable.

  • latest tracks the current latest version release.
  • dev tracks the current dev branch image.
  • X.Y.Z tags are versioned releases.
  • X.Y tags float within a release line.
  • Pushes to dev also publish a short commit SHA tag.

Run the latest image with:

docker run --rm -p 8080:8080 ghcr.io/sableclient/sable:latest

Then open http://localhost:8080.

If you want to override the bundled config.json, mount your own file at /app/config.json:

services:
  sable:
    image: ghcr.io/sableclient/sable:latest
    ports:
      - '8080:8080'
    volumes:
      - ./config.json:/app/config.json:ro

Build it yourself

To build and serve Sable yourself with nginx, clone this repo and build it:

pnpm i # Installs all dependencies
pnpm run build # Compiles the app into the dist/ directory

After that, you can copy the dist/ directory to your server and serve it.

  • In the config.json, you can modify the default homeservers, feature rooms/spaces, toggle the account switcher, and toggle experimental simplified slilding sync support.

Optional default client settings

While the default settings are recommended for most users, you can optionally add a top-level "settingsDefaults" object whose keys match client settings (only fields you want to override) to override them. The default settings for any new logins will match these. Existing keys in local storage or users who chose to sync settings with their account data will still have their settings set.

For example:

{
  "settingsDefaults": {
    "hour24Clock": true,
    "pageZoom": 110,
    "messageLayout": 2,
    "rightSwipeAction": "members",
    "captionPosition": "below",
    "renderUserCards": "both",
    "jumboEmojiSize": "large"
  }
}

Invalid or unknown keys are ignored.

  • To deploy on subdirectory, you need to rebuild the app youself after updating the base path in build.config.ts.
    • For example, if you want to deploy on https://sable.moe/app, then set base: '/app'.

Local development

Tip

The easiest way to get started is with mise, it manages node, pnpm, rust, and other tooling.

mise install    # Install all required tools
mise run setup  # Install dependencies (pnpm install)
mise run dev    # Start the Vite dev server

Run mise tasks to list all available tasks (build, test, lint, etc.).

To build the app:

mise run build

Desktop & Mobile (Tauri)

Sable uses Tauri for native desktop and mobile builds.

mise run tauri:setup          # Install Rust toolchain + system packages
mise run tauri:setup:macos    # Install Xcode (macOS only)
mise run tauri:setup:windows  # Install VS Build Tools + WebView2 (Windows only)
mise run tauri wry dev        # Dev server with system webview (WebKit/WebView2)
mise run tauri cef build      # Production build with Chromium Embedded Framework
mise run tauri --help         # Any other args pass through to the Tauri CLI

When the first argument is wry or cef and the second is dev or build, the wrapper injects --features <runtime>,updater --no-default-features. Everything else is forwarded to tauri as-is.

Deployment and infrastructure

Deployment workflows and infrastructure details live in infra/README.md.

S
Description
No description provided
Readme AGPL-3.0
107 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 93.2%
Rust 5.2%
JavaScript 0.8%
Kotlin 0.2%
CSS 0.2%
Other 0.3%