whatisgithub

What is element-android?

element-hq/element-android — explained in plain English

Analysis updated 2026-07-03

3,685KotlinAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

Element Android is the older version of the Element messaging app for Android, connecting to the open Matrix network for decentralized communication. It still receives security patches but no new features, new users should install Element X instead.

Mindmap

mindmap
  root((Element Android))
    What it does
      Matrix messaging
      Room-based collaboration
      Decentralized network
    Versions
      Classic security-only
      Element X recommended
    Install options
      Google Play Store
      F-Droid open-source
    For developers
      Matrix Android SDK
      Contributor community
    License
      AGPL-3.0 free
      Commercial license paid
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a Matrix-compatible Android messaging app on top of the extracted Matrix Android SDK without forking Element directly.

USE CASE 2

Study a production-grade Kotlin Android app that implements the Matrix protocol for decentralized messaging.

USE CASE 3

Run a self-hosted Matrix server and connect to it using this open-source client as an alternative to proprietary messaging apps.

USE CASE 4

Contribute security fixes to the classic Element Android app while the team focuses feature work on Element X.

What is it built with?

KotlinAndroidMatrix

How does it compare?

element-hq/element-androidbufferapp/android-clean-architecture-boilerplategradle/kotlin-dsl-samples
Stars3,6853,6863,687
LanguageKotlinKotlinKotlin
Setup difficultyhardmoderateeasy
Complexity4/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Android Studio and a running Matrix homeserver to connect to for full testing.

Free to use and modify under AGPL-3.0, which requires sharing source code for any network-accessible service, a paid commercial license is also available from New Vector Ltd.

So what is it?

Element Android is a messaging and collaboration app for Android devices. It connects to the Matrix network, which is an open standard for decentralized communication, meaning your messages are not locked into any single company's servers. The app lets you join rooms, send messages, and collaborate with others across any Matrix-compatible server. This repository contains the older, classic version of the app, sometimes called Element Classic. The README is clear that this version still receives security updates but no longer gets new features or usability improvements. The team recommends that new users install Element X instead, which is the newer next-generation version with ongoing feature development. The app runs on any Android device with Android 5.0 (Lollipop, API level 21) or newer. It is available through the Google Play Store and through F-Droid, an alternative app store that only distributes open-source software. Because F-Droid builds the app from source code itself to verify it matches what is published, releases there typically appear a day or more after the Google Play version. The codebase also contains a Matrix Android SDK that is extracted into a separate repository with each release, so other developers can build their own Matrix-compatible apps on top of it without forking Element directly. The software is dual-licensed. You can use it for free under the GNU Affero General Public License version 3, or under a paid commercial license from New Vector Ltd, the company behind Element. Contributors are welcome, and the README points to contributor documentation and a Matrix chat room where the developer community is active.

Copy-paste prompts

Prompt 1
Using the Element Android Matrix SDK, show me how to connect to a Matrix homeserver, log in, and send a message to a room in Kotlin.
Prompt 2
I want to build my own Android chat app on top of the Matrix protocol. Based on Element Android's SDK, walk me through the minimum code needed to join a room and receive messages.
Prompt 3
Help me set up a local development environment for Element Android so I can build the APK from source and run it on an emulator.
Prompt 4
Explain how Element Android handles end-to-end encryption for Matrix messages and what parts of the codebase manage key storage and verification.

Frequently asked questions

What is element-android?

Element Android is the older version of the Element messaging app for Android, connecting to the open Matrix network for decentralized communication. It still receives security patches but no new features, new users should install Element X instead.

What language is element-android written in?

Mainly Kotlin. The stack also includes Kotlin, Android, Matrix.

What license does element-android use?

Free to use and modify under AGPL-3.0, which requires sharing source code for any network-accessible service, a paid commercial license is also available from New Vector Ltd.

How hard is element-android to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is element-android for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.