Matrix Usage Guide at ISIMA — Part 2: Mobile (Element X)✯
Documentation intended for users of the ISIMA (LIMOS Laboratory) Matrix messaging service. This section covers installation and first connection on Android and iOS using the Element X application (current generation of the Element app, replacing the old "Element Classic").
Prerequisites: have a working web session (Part 1) and your recovery key noted (see Part 1: Save your recovery key) — useful for device verification.
Installing Element X✯
Scan the QR code corresponding to your phone using the camera (on Android, Google Play opens directly; on iOS, the App Store):

| Platform | Direct Link |
|---|---|
| Android (Google Play) | io.element.android.x — https://play.google.com/store/apps/details?id=io.element.android.x |
| Android (F-Droid, without Google) | https://f-droid.org/packages/io.element.android.x/ |
| iOS / iPadOS (App Store) | https://apps.apple.com/app/id1631335820 |
Android without Google Play: the package is available on F-Droid (main repository). Add https://f-droid.org if the store is not already installed, then search for "Element X".
First Connection on Element X✯
Welcome Screen✯
Open Element X: the home screen ("Be in your Element") offers "Log in with a QR code", "Log in manually", and "Create an account". Tap "Log in manually".
The QR option allows pairing an already logged-in session without re-entering the password — however, it is marked as "not supported" with ISIMA authentication (see Device Verification); use "Log in manually".

Enter Account Provider✯
The next screen asks for your "Account Provider" — this is the server domain, not your username or password:
- Enter
isima.fr(ormatrix.isima.fr, used in our screenshot); - The app automatically detects the school's configuration (homeserver
https://matrix.isima.fr, MAS authentication) and redirects you to the login page.

Your Matrix ID (
@username:isima.fr, e.g.@tibertra:isima.fr) is automatically created and associated during SSO login, just like on the web (Part 1, § 2.3) — nothing to enter here.
Login via ISIMA SSO✯
The browser opens the school's authentication portal — exactly the same as on the web:
- Username or email: your ISIMA username;
- Password: your ISIMA password;
- Log in.

Then, the consent screen "Continue to Element X?": tap Continue to allow Element X to use your ISIMA account.

You are automatically returned to the app, which then asks you to confirm your digital identity (see Device Verification).
Device Verification✯
On first login, Element X asks you to confirm your digital identity to enable encrypted messaging. Two methods are offered:
- Use another session — recommended if you already have a verified session available (the web version from Part 1): cross-verification compares a unique set of emojis on both devices;
- Use recovery key — if no other session is available: enter the 11 groups of 4 characters noted in Part 1, § 3.2.

Without verification (or key), encrypted rooms will remain unreadable on your phone, and your contacts won't be able to trust your device.
Cross-verification with another session (emoji method)✯
- Choose "Use another session"
- The screen "Open the app on another verified device" appears: ensure your web (or desktop) session is open, then tap "Start verification".

- The phone waits: "Start verification on the other device — once accepted, you can continue verification".

- On the web: a banner "Verification required" appears at the top left (or via Settings → Sessions), with the buttons Ignore / Start verification — click "Start verification" (the request expires after a few minutes; restart it from the phone if needed).

- The phone displays "Compare emojis": tap Start.

- Both devices display the same unique set of emojis (e.g. Pig, Fish, Banana, Cake, Balloon, Alarm, Hammer...):

-
Compare: if they match, tap "They match" on the phone, then confirm on the web ("All good" / Finish). If they don't match, tap "They don't match" and try again (the list is regenerated).
-
Final screen: "Verified device — You can now read and send messages securely, and anyone you chat with can also trust this device."

On the web, Settings → Sessions now shows all Verified sessions (the web session and "Element X on

Alternative: recovery key✯
If you don't have another session available, choose "Use recovery key" on the "Confirm your digital identity" screen and enter your key (see Part 1: Save your recovery key). The effect is identical: the device is verified, and encrypted history becomes readable again.
Connection via QR code ("Pair a new device") is marked as not supported by your account provider with ISIMA authentication — use emoji verification or the recovery key.
First Steps on Mobile✯
- The room list is identical to the web: filters Unread / People / Rooms / Favorites, and your rooms appear with their decrypted history;
- Enable notifications when the system prompts you (Android / iOS permission);
- The "You have unverified sessions" banner disappears once verification is complete (Later lets you postpone it);
- The search (magnifying glass, at the top) finds rooms, people, and messages.
After verification, conversations open with their readable encrypted history — here the Demo-formation room and its test message:

Troubleshooting✯
| Symptom | Solution |
|---|---|
| "Account provider" rejected | Enter isima.fr, or matrix.isima.fr; check spelling (no spaces) |
| SSO page loops or doesn't load | Verify your ISIMA credentials on another service first, then restart "Log in manually" |
| Verification request expires | Restart "Start verification" from the phone and confirm on the web within ~5 minutes |
| Encrypted rooms unreadable (locks) | Re-verify the device: cross-verification or recovery key |
| Pairing QR "not supported" | Normal with ISIMA authentication — use "Log in manually" |
| No notifications | Device system settings → Element X → Allow notifications |