7w1 7675aa1520 chore: prepare release 1.21.0 (#1110)
> **Preview the next release on [dev.sable.moe](https://dev.sable.moe)**

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

## Features

* Add the `forum` room type with a dedicated forum view that presents
threads as topics. by @smokku in #980
* New composer commands: `/gif` opens the GIF picker and `/rainbowme`
sends rainbow-formatted action messages (#1109). by @eleboucher in #1573
* Add selectable app icons on Android and iOS. by @eleboucher in #1594
* Add MSC4466 profile sync controls for supported homeservers. by @7w1
in #1117
* Add experimental new calls using LiveKit on web, desktop, and
supported mobile devices, enabled by a single setting with Element Call
as the fallback. by @eleboucher in #1575
* Add toggleable, reorderable composer trigger buttons (emoji, gif,
sticker) with a drag-and-drop settings list. by @eleboucher in #1261
* Settings improvements: search the settings sidebar and customize
keyboard shortcuts (#1121). by @eleboucher in #1660
* Add an accessibility settings tab with color correction filters. by
@j0lol in #1664
* Persona improvements: pick a persona directly in the editor, an
account-wide persona toggle, latching shorthands, persona name colors,
and a redesigned persona settings menu (#1223, #1264, #1368, #1369,
#1435, #1462). by @j0lol in #1171
* Style tables in formatted messages. by @Steffo99 in #1580
* New bottom sheets across the app: attach files and pick emoji from
sheets in the composer, plus a room details sheet on small screens
(#1173, #1433). by @eleboucher in #1234
* Update the device display name after login to reflect the current
client and build flavor. by @hazre in #1458
* Replaced the connection status top bar with a small styled popup and
added a variant that shows sliding sync initial progress. by @7w1 in
#1200
* Add per-message profiles (MSC4461): a different name and avatar in
each room, with PluralKit import, shorthands, backup and restore,
editing sent messages, and profile info on user profiles (#1352, #1479,
#1586, #1611, #1651, #1701). by @j0lol in #1589
* The notifications inbox is now built from push rules evaluated on this
device instead of the server's `/notifications` endpoint, so mentions in
encrypted rooms are detected correctly. by @eleboucher in #1372
* Add beta desktop and mobile builds with a greatly improved mobile
experience, UnifiedPush support and more reliable notifications, better
desktop shortcuts, updates and window controls, and improved native
media handling and sharing. by @eleboucher in #1103

## Fixes

* Publish an `obtainium.json` app config with every release so Android
builds can be installed and auto-updated through Obtainium. by
@eleboucher in #1616
* Performance: faster startup and warm syncs by caching room metadata,
profile data, and device verification, plus lower memory use by pruning
inactive room history (#1127, #1184, #1305, #1466). by @7w1 in #1118
* Login and account fixes: full-URL homeservers no longer land on an
empty room, a retry button when discovery fails, OAuth device
verification no longer hangs, identity reset completes, key backup
restores on verified devices, and account switch or logout from the
offline screen (#1115, #1270, #1348, #1379, #1380). by @eleboucher in
#1582
* Media fixes: encrypted images and GIFs render again, playback works on
Firefox, better loading on slow connections, decrypted media is freed
from memory, gzipped Lottie support, stickers send reliably, and
notification sounds no longer play as media (#1104, #1296, #1331, #1332,
#1334, #1353, #1381). by @eleboucher in #1271
* Fix link previews leaving empty space in a message until it is
reloaded by @eleboucher in #1827
* Message formatting fixes: checklists no longer render as raw HTML,
spoilers work with proxy tags, maps with malformed coordinates no longer
crash the app, and membership reasons are wrapped in parentheses (#1248,
#1307, #1470). by @eleboucher in #1354
* Fix context menus closing instead of opening, keep the room options
sheet open, and let sidebar, space, and image viewer menus open on
long-press as well as right-click (#1336, #1358). by @eleboucher in
#1431
* Assorted fixes: popups on start appear one at a time, room leave
updates immediately, accepted invites stop reappearing, synced CSS
tweaks are restored, the scheduled-messages chip shows again, faster
recovery from network switches, plus small visual and formatting fixes
(#1114, #1120, #1146, #1200, #1220, #1284, #1514, #1656). by @eleboucher
in #1399
* Profile fixes: hero colours and full scrolling restored on profile
sheets, local time respects the 24-hour setting, devices stay sorted
when last-active times are missing, and no crash in room cosmetics
before members load (#1298, #1579, #1793). by @eleboucher in #1503
* Fix sliding sync issues: missing or stale display names, bridged
avatars, blank space icons, sticker and emote packs, subspaces, call
updates, and incomplete member lists (#1111, #1112, #1119, #1173, #1530,
#1554). by @7w1 in #1170
* Notification and unread fixes: rooms no longer stay unread after a
thread reply or restart, the inbox shows real message previews, the page
title shows the mention count, and tapping a notification navigates
correctly (#1245, #1390). by @eleboucher in #1816
* Timeline fixes: reliably follow new messages, stop loading a room's
whole history on open, unstuck pagination, restored polls, and fixed
thread rendering, reactions, and replies (#1113, #1358, #1363, #1367,
#1373, #1425). by @eleboucher in #1105
* Fix voice recordings continuing after cancel or rapid taps, and stop
the microphone when a recording is interrupted before the permission
prompt resolves (#1428). by @eleboucher in #1252
* Add option to always keep the last line of the text editor "inline"
with the UI buttons. by @lunar-seal in #1218
* Mobile polish: smoother swipe navigation and drawer, steady keyboard
while editing, better touch feedback, chat input and account panel,
swipe-to-edit on messages, and fixed swiping in attachments (#1103,
#1130, #1131, #1144, #1173, #1267, #1303, #1382, #1754). by @eleboucher
in #1166
2026-08-17 16:05:42 -05:00
2026-08-17 20:52:05 +00:00
2026-07-27 06:01:32 +03:00
2026-08-11 20:47:28 +02:00
2026-07-26 14:51:16 -05:00
2026-08-17 20:52:05 +00:00
2026-08-17 17:29:58 +02:00
2026-03-05 22:34:11 -06:00
2026-07-24 19:45:52 -05:00
2026-08-17 20:52:05 +00:00
2026-07-30 14:21:10 -05:00
2026-08-17 20:28:49 +00:00
2023-02-24 17:28:04 +05:30
2026-07-19 01:06:28 +02:00
2026-08-17 20:52:05 +00:00
2026-07-24 19:42:44 -05:00
2026-05-13 12:42:00 -05:00
2026-08-13 08:25:37 +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.

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%