Mirror of Element Android source
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 0c4510250b
Merge pull request #7241 from vector-im/feature/bma/gradle_doctor
17 hours ago
.github tests workflow will now update gradle cache when run against develop (#7238) 18 hours ago
.idea Add `unifiedpush` to the project dict. 4 months ago
changelog.d Instrumentation test coroutines (#7207) 21 hours ago
docs Merge pull request #7115 from vector-im/docs/unit-testing 2 days ago
fastlane Update changelog 1.5.0 for fastlane 5 days ago
gradle/wrapper Update Gradle Wrapper from 7.5 to 7.5.1. 2 months ago
library Merge pull request #7231 from pt2121/pt/12-flip-table 1 day ago
matrix-sdk-android Instrumentation test coroutines (#7207) 21 hours ago
matrix-sdk-android-flow Start DM - Add loading wheel while creating the room 1 week ago
resources/img put F-Droid and GPlay badges locally 2 years ago
tools Merge pull request #7241 from vector-im/feature/bma/gradle_doctor 17 hours ago
vector Merge pull request #7129 from vector-im/feature/adm/screenshot-testing-example-test 23 hours ago
vector-app app layout labs flag is enabled by default (#7237) 1 day ago
vector-config app layout labs flag is enabled by default (#7237) 1 day ago
.editorconfig Enables trailing comma editor config 2 months ago
.gitattributes including git lfs config for picking up screenshot test recordings 2 days ago
.gitignore ignoring the screenshot failure results from git 2 days ago
AUTHORS.md Add ability to share profile by QR code 2 years ago
CHANGES.md Applayout: disable applayout by default 5 days ago
Gemfile Setup Danger to Element Android project. 2 months ago
Gemfile.lock Run `bundle update` again. 1 month ago
LICENSE Update README.md & Create LICENSE 4 years ago
README.md Reduce link size. 2 weeks ago
build.gradle Merge pull request #7241 from vector-im/feature/bma/gradle_doctor 17 hours ago
coverage.gradle using debug variant for the vector CA tests, gplay only exists at the root level 2 weeks ago
dependencies.gradle Bump libphonenumber from 8.12.55 to 8.12.56 19 hours ago
dependencies_groups.gradle adding paparazzi screenshot testing lib setup 2 days ago
gradle.properties removing jetifier screenshot config as the jetifier is no longer needed 2 days ago
gradlew Update Gradle Wrapper from 7.4.2 to 7.5. 3 months ago
gradlew.bat Update Gradle Wrapper from 7.4.2 to 7.5. 3 months ago
integration_tests_script.sh - Fix integration tests (still not perfect while github actions are very very limited for that) 9 months ago
integration_tests_script_github.sh - Fix integration tests (still not perfect while github actions are very very limited for that) 9 months ago
settings.gradle moving external library modules to an external directory 2 weeks ago
towncrier.toml updating the removal towncrier usage to be an explicit sdk category 9 months ago


Buildkite Weblate Element Android Matrix room #element-android:matrix.org Quality Gate Status Vulnerabilities Bugs

Element Android

Element Android is an Android Matrix Client provided by Element. The app can be run on every Android devices with Android OS Lollipop and more (API 21).

It is a total rewrite of Riot-Android with a new user experience.

Get it on Google Play Get it on F-Droid

Nightly build: Buildkite Nightly test status: allScreensTest

New Android SDK

Element is based on a new Android SDK fully written in Kotlin (like Element). In order to make the early development as fast as possible, Element and the new SDK currently share the same git repository.

At each Element release, the SDK module is copied to a dedicated repository: https://github.com/matrix-org/matrix-android-sdk2. That way, third party apps can add a regular gradle dependency to use it. So more details on how to do that here: https://github.com/matrix-org/matrix-android-sdk2.


The version 1.0.0 of Element still misses some features which was previously included in Riot-Android. The team will work to add them on a regular basis.

Releases to app stores

There is some delay between when a release is created and when it appears in the app stores (Google Play Store and F-Droid). Here are some of the reasons:

  • Not all versioned releases that appear on GitHub are considered stable. Each release is first considered beta: this continues for at least two days. If the release is stable (no serious issues or crashes are reported), then it is released as a production release in Google Play Store, and a request is sent to F-Droid too.
  • Each release on the Google Play Store undergoes review by Google before it comes out. This can take an unpredictable amount of time. In some cases it has taken several weeks.
  • In order for F-Droid to guarantee that the app you receive exactly matches the public source code, they build releases themselves. When a release is considered stable, Element staff inform the F-Droid maintainers and it is added to the build queue. Depending on the load on F-Droid's infrastructure, it can take some time for releases to be built. This always takes at least 24 hours, and can take several days.

If you would like to receive releases more quickly (bearing in mind that they may not be stable) you have a number of options:

  1. Sign up to receive beta releases via the Google Play Store.
  2. Install a release APK directly - download the relevant .apk file and allow installing from untrusted sources in your device settings. Note: these releases are the Google Play version, which depend on some Google services. If you prefer to avoid that, try the latest dev builds, and choose the F-Droid version.
  3. If you're really brave, install the very latest dev build - click on Assemble (GPlay or FDroid) Debug version then on Artifacts.


Please refer to CONTRIBUTING.md if you want to contribute on Matrix Android projects!

Come chat with the community in the dedicated Matrix room.

Also this documentation can hopefully help developers to start working on the project.

Triaging issues

Issues are triaged by community members and the Android App Team, following the triage process.

We use issue labels to sort all incoming issues.