Skip to content

Getting Started

rockcutto edited this page Oct 5, 2026 · 1 revision

Getting Started

This page covers the basic path from installing LibreSpan to starting your first protected conversation.

1. Install LibreSpan

Use the APK from an official project release or a trusted software catalog when available.

Android may show its standard warning for apps installed outside an app store. Verify the APK source and avoid unknown mirrors.

2. Sign in to an XMPP account

LibreSpan uses a normal XMPP JID:

user@example.org

Enter the full account address and password.

LibreSpan does not require an account on a specific provider. If the selected server supports XMPP account registration, the app may offer account creation.

3. Add a contact

Add a contact using their XMPP JID:

friend@example.net

LibreSpan then uses the features supported by the server and by the other client's implementation.

4. OMEMO

LibreSpan supports OMEMO for personal conversations.

Verify device fingerprints, especially when:

  • the contact is important;
  • you have previously verified their devices;
  • a new device appears unexpectedly;
  • the conversation contains sensitive information.

Fingerprint verification should use an independent trusted channel.

5. Media and files

LibreSpan supports:

  • images;
  • video;
  • audio;
  • voice messages;
  • arbitrary files.

Media handled by LibreSpan's protected path is stored in the application's local protected storage. Explicit Save and Share actions are export boundaries outside that protected store.

6. Audio and video calls

When the server and both clients support the required XMPP/Jingle capabilities, LibreSpan can make audio and video calls.

Call quality depends on:

  • network quality;
  • NAT/firewall behavior;
  • STUN/TURN availability;
  • server capabilities;
  • the peer client's implementation.

7. Channels and group chats

LibreSpan supports XMPP MUC.

Depending on role and server capabilities, features may include:

  • joining rooms;
  • invitations;
  • roles and affiliations;
  • moderation;
  • message retraction/moderation;
  • MAM history.

8. App Lock and High Security

These controls solve different problems.

App Lock restricts access to the LibreSpan UI.

High Security strengthens protection of local key material and protected data after application or device restart.

See Security Model.

9. Troubleshooting before opening an issue

Useful information includes:

  • LibreSpan version;
  • Android version;
  • server;
  • whether the same account works in another XMPP client;
  • whether the issue survives a restart;
  • whether the issue affects only one contact or one room.

Do not post passwords, recovery phrases, private messages, private JIDs, or sensitive logs in public issues.

Clone this wiki locally