Repository navigation
Getting Started
This page covers the basic path from installing LibreSpan to starting your first protected conversation.
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.
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.
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.
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.
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.
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.
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.
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.
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.