A Freedom Respecting Android Chat Client https://mercury-im.org
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.

1.5 KiB


Mercury-IM will be an XMPP messenger that aims to be portable. Most of the core logic is pure Java, so the final goal is to make it as easy as possible to add different UIs for different platforms on top of it.


  • Mercury IM's development tries to follow architectural principles know from Clean Architecture.
  • The app is developed using the MVVM (Model View Viewmodel) pattern
  • Components are wired together using Dependency Injection (DI) with Dagger 2
  • Data is persisted using the requery ORM framework


Since there are some issues with Android Studio and composite builds, it is currently only possible to build Mercury-IM either using the Gradle command line tool (see below), or by using Android Studio 3.5.3.

git clone <project-url>
cd <project-directory>
git submodule update --init --recursive
gradle assembleDebug


  • I want to develop, but lots of org.jivesoftware.smackx.* classes cannot be found!
    • You forgot to type git submodule init && git submodule update as mentioned above
  • It looks like I'm missing org.mercury_im.messenger.data.* classes???
    • In Android Studio select the data module and then click "Build -> Make Module 'data'".