Android Matrix messenger application using the Matrix Rust Sdk and Jetpack Compose
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Benoit Marty 98bf6856ab
Merge pull request #3806 from element-hq/mxandreas-update-status
17 hours ago
.github chore(deps): update mobile-dev-inc/action-maestro-cloud action to v1.9.2 4 weeks ago
.idea Kotlin 2.0.21 3 weeks ago
.maestro Fix Maestro test. 2 months ago
anvilannotations Migrate license to AGPL. 2 months ago
anvilcodegen Use Anvil KSP instead of the Square KAPT one (#3564) 1 month ago
app Merge pull request #3776 from element-hq/feature/bma/targetApi35 18 hours ago
appconfig Add "Learn more" on identity verification first screen. 4 weeks ago
appicon Migrate license to AGPL - XML files. 2 months ago
appnav Sync Strings from Localazy 2 days ago
docs Improve screenshot testing with ComposablePreviewScanner (#3125) 4 months ago
enterprise@b4f0427e35 Use Anvil KSP instead of the Square KAPT one (#3564) 1 month ago
fastlane/metadata/android/en-US Adding fastlane file for version 0.7.1 2 weeks ago
features Merge pull request #3776 from element-hq/feature/bma/targetApi35 18 hours ago
gradle fix(deps): update dependency androidx.constraintlayout:constraintlayout to v2.2.0 1 day ago
libraries Merge pull request #3776 from element-hq/feature/bma/targetApi35 18 hours ago
plugins Fix warning in Versions.kt: const and naming convention. 6 days ago
samples/minimal Fix warning in Versions.kt: const and naming convention. 6 days ago
screenshots Sync Strings from Localazy 2 days ago
services Fix test `present - with CallType RoomCall sets call as active, loads URL, runs WidgetDriver and notifies the other clients a call started` not passing. 6 days ago
tests fix(deps): update dependency androidx.compose:compose-bom to v2024.10.01 (#3782) 2 days ago
tools When building a snapshot of the SDK bindings, don't build the app by default too 2 weeks ago
.editorconfig Ktlint: disable rule standard:blank-line-before-declaration. 10 months ago
.gitattributes Generate screenshots for foreign languages ("de" and "fr" for now). #2454 8 months ago
.gitignore Git ignore .kotlin folder. 4 weeks ago
.gitmodules Add git@github.com:element-hq/element-android-enterprise.git as a git module. 4 months ago
AUTHORS.md Organization renaming: replace all `https://github.com/vector-im` by `https://github.com/element-hq` 11 months ago
CHANGES.md Changelog for version 0.7.2 1 week ago
CODEOWNERS Update CODEOWNERS after organization renaming 11 months ago
CONTRIBUTING.md Towncrier removal: update the contributing doc. 4 months ago
Gemfile Add Gemfile to be able to run danger locally. 2 years ago
LICENSE Copy licence from https://www.gnu.org/licenses/agpl-3.0.txt 2 months ago
README.md Update project status 17 hours ago
build.gradle.kts Update dependency io.nlopez.compose.rules:detekt to v0.4.17 1 week ago
gradle.properties Update android.gradle.plugin to v8.7.0 (#3577) 1 month ago
gradlew Update Gradle Wrapper from 8.9 to 8.10. 3 months ago
gradlew.bat Update Gradle Wrapper from 8.9 to 8.10. 3 months ago
settings.gradle.kts Migrate license to AGPL 2 months ago

README.md

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 a Matrix Android Client provided by element.io.

The application is a total rewrite of Element-Android 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.

Learn more about why we are building Element X in our blog post: https://element.io/blog/element-x-experience-the-future-of-element/.

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 in an early rollout and migration phase.

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. Makes sure to select the app configuration when building (as we also have sample apps in the project).

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 New Vector Ltd.

Licensed under the AGPL-3.0-only (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

https://www.gnu.org/licenses/agpl-3.0.txt

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