Element X Android with room list sections shared with Element Web; personal releases in the F-Droid repository at https://files.lyte.dev/fdroid/repo
  • Kotlin 98.7%
  • Shell 0.6%
  • Python 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Daniel Flanagan dbe6d5538e
All checks were successful
Personal release / release (push) Successful in 26m13s
fix(release): publish without setgid modes inside the runner sandbox
The v26.09.4-lytedev.3 release built and signed, then failed copying
the served repository into the workspace: cp -a creates each copied
directory with its 2775 mode, and the android-release runner's unit has
RestrictSUIDSGID=yes, which refuses any mkdir or chmod carrying a
setgid bit. cp --no-preserve=mode still passes the bit to mkdir. The
previous commit's --chmod=D2775 on the way back would have failed the
same way for any new directory.

Both directions now use rsync without --perms and with
--chmod=D775,F664 under umask 002, so no call asks for setgid: new
directories in the served tree still get the bit and the
fdroid-publishers group from their parent, which the kernel applies
rather than the process.

Tested with systemd-run on beefcake under the runner's properties
(DynamicUser, SupplementaryGroups, RestrictSUIDSGID, UMask=0022,
PrivateTmp, NoNewPrivileges, ProtectSystem=strict with ReadWritePaths):
the old cp exits 1 with the release's error; the rsync version
publishes twice in a row into a root:wheel 2775 tree, deletes a stale
file and leaves 2775/664 group-owned entries. Also ran the full script
twice into an empty local directory with a throwaway key.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FEkqyhgPYauDRFrGNqncpC
2026-10-11 04:14:38 -05:00
.forgejo/workflows fix(ci): notify of a failed release even when checkout failed 2026-10-11 02:55:15 -05:00
.github Do not list enterprise commit messages in the submodule update PR 2026-10-09 10:33:22 +02:00
.idea Fix compilation warnings after Kotlin 2.4.20 and KSP 2.3.12 upgrade 2026-10-01 16:45:18 +02:00
.maestro Fix Maestro tests 2026-09-29 15:57:08 +02:00
annotations Update ContributesNodeProcessor so that generated classes follow naming convention 2026-08-24 11:31:22 +02:00
app build(app): build personal releases with their own id, name and key 2026-10-11 00:04:21 -05:00
appconfig Remove unused Gradle dependencies 2026-10-02 15:47:48 +02:00
appicon Copyright: Add Element Creations Ltd. copyright 2025-11-10 11:05:05 +01:00
appnav Add edit and redaction send state support (#7840) 2026-10-09 10:30:52 +02:00
codegen Fix compilation warnings after Kotlin 2.4.20 and KSP 2.3.12 upgrade 2026-10-01 16:45:18 +02:00
docs Update docs/nightly_build.md 2026-09-15 17:26:18 +03:00
enterprise@5c06c0f1e4 Update enterprise submodule to latest main 2026-10-09 08:30:21 +00:00
fastlane/metadata/android/en-US Adding fastlane file for version 26.09.4 2026-09-29 16:37:05 +02:00
features feat(home): mark every room of a room list section as read 2026-10-10 14:42:44 -05:00
gradle Merge pull request #7886 from element-hq/feature/valere/element_call_rc7 2026-10-09 14:45:39 +02:00
libraries build(matrix): let release builds use the local Rust SDK AAR on request 2026-10-11 00:04:01 -05:00
plugins Merge branch 'hotfix/26.09.4' into develop 2026-09-29 18:31:14 +02:00
screenshots Sync Strings from Localazy 2026-10-05 00:40:51 +00:00
services Remove unused Gradle dependencies 2026-10-02 15:47:48 +02:00
tests Merge pull request #7883 from element-hq/feature/bma/roomSelectSearchField 2026-10-09 15:09:50 +02:00
tools fix(release): publish without setgid modes inside the runner sandbox 2026-10-11 04:14:38 -05:00
.editorconfig Restore no-unused-imports behaviour for ktlintFormat 2025-12-04 10:18:19 +01:00
.gitattributes Import Compound tests from project https://github.com/element-hq/compound-android 2025-10-06 10:47:31 +02:00
.gitignore Fix warning about deprecated Gradle keepRules.file API (#7498) 2026-08-21 13:23:34 +00:00
.gitmodules Add git@github.com:element-hq/element-android-enterprise.git as a git module. 2024-06-26 11:58:42 +02:00
AGENTS.md Add consign when AI adds new states for screenshot. 2026-10-06 09:05:28 +02:00
AUTHORS.md Organization renaming: replace all https://github.com/vector-im by https://github.com/element-hq 2023-12-13 09:40:07 +01:00
build.gradle.kts Merge pull request #7700 from element-hq/renovate/kotlin 2026-10-05 15:21:42 +02:00
CHANGES.md Fix aaptDump.txt and changelog 2026-09-29 22:03:13 +02:00
CLAUDE.md Create AGENTS.md 2026-03-25 12:19:26 +01:00
CODEOWNERS Update CODEOWNERS after organization renaming 2023-12-12 13:54:32 +01:00
CONTRIBUTING.md Add Stefan's etiquette to the project. (#6909) 2026-05-29 15:59:54 +02:00
flake.lock build(nix): add devShells for the app, the Rust SDK and releases 2026-10-11 00:04:21 -05:00
flake.nix build(nix): add devShells for the app, the Rust SDK and releases 2026-10-11 00:04:21 -05:00
gradle.properties Stop rewriting screenshots that did not meaningfully change 2026-10-01 15:46:28 +02:00
gradlew Update Gradle Wrapper from 9.5.1 to 9.6.1 2026-07-17 13:59:33 +00:00
gradlew.bat Update Gradle Wrapper from 9.7.1 to 9.8.0 2026-09-25 00:45:46 +00:00
LICENSE Copy licence from https://www.gnu.org/licenses/agpl-3.0.txt 2024-09-06 16:39:00 +02:00
LICENSE-COMMERCIAL New LICENSE-COMMERCIAL file 2025-01-07 09:59:50 +01:00
README.md vector-im -> element-hq 2025-11-17 18:04:54 +01:00
settings.gradle.kts Update Matrix Rust SDK to 26.10.05-nightly (#7844) 2026-10-07 11:13:36 +02:00

Latest build Quality Gate Status Vulnerabilities Bugs codecov Element X Android Matrix room #element-x-android:matrix.org Localazy

Element X Android

Element X Android is the next-generation Matrix client provided by Element.

Compared to the previous-generation Element Classic, the application is a total rewrite, using the Matrix Rust SDK underneath and targeting devices running Android 7+. The UI layer is written using Jetpack Compose, and the navigation is managed using Appyx.

Get it on Google PlayGet it on F-Droid

Table of contents

Screenshots

Here are some screenshots of the application:

Translations

Element X Android supports many languages. You can help us to translate the app in your language by joining our Localazy project. You can also help us to improve the existing translations.

Note that for now, we keep control on the French and German translations.

Translations can be checked screen per screen using our tool Element X Android Gallery, available at https://element-hq.github.io/element-x-android/. Note that this page is updated every Tuesday.

More instructions about translating the application can be found at CONTRIBUTING.md.

Rust SDK

Element X leverages the Matrix Rust SDK through an FFI layer that the final client can directly import and use.

We're doing this as a way to share code between platforms and while we've seen promising results it's still in the experimental stage and bound to change.

Status

This project is actively developed and supported. New users are recommended to use Element X instead of the previous-generation app.

Minimum SDK version

Element X Android requires a minimum SDK version of 24 (Android 7.0, Nougat). We aim to support devices running Android 7.0 and above, which covers a wide range of devices still in use today.

Element Android Enterprise requires a minimum SDK version of 33 (Android 13, Tiramisu). For Element Enterprise, we support only devices that still receive security updates, which means devices running Android 13 and above. Android does not have a documented support policy, but some information can be found at https://endoflife.date/android.

Contributing

Want to get actively involved in the project? You're more than welcome! A good way to start is to check the issues that are labelled with the good first issue label. Let us know by commenting the issue that you're starting working on it.

But first make sure to read our contribution guide first.

You can also come chat with the community in the Matrix room dedicated to the project.

Build instructions

Just clone the project and open it in Android Studio. Make sure to select the app configuration when building (as we also have sample apps in the project).

To build against a local copy of the Rust SDK, see the Developer onboarding instructions.

Support

When you are experiencing an issue on Element X Android, please first search in GitHub issues and then in #element-x-android:matrix.org. If after your research you still have a question, ask at #element-x-android:matrix.org. Otherwise feel free to create a GitHub issue if you encounter a bug or a crash, by explaining clearly in detail what happened. You can also perform bug reporting from the application settings. This is especially recommended when you encounter a crash.

Copyright (c) 2025 Element Creations Ltd. Copyright (c) 2022 - 2025 New Vector Ltd.

This software is dual licensed by Element Creations Ltd (Element). It can be used either:

(1) for free under the terms of the GNU Affero General Public License (as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version); OR

(2) under the terms of a paid-for Element Commercial License agreement between you and Element (the terms of which may vary depending on what you and Element have agreed to).

Unless required by applicable law or agreed to in writing, software distributed under the Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.