Native XMPP client for Ubuntu Touch and Sailfish OS.
  • Rust 75.3%
  • QML 24.1%
  • Shell 0.4%
  • Python 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-27 12:16:04 +02:00
.cargo Enforce omemo in private groups. 2026-07-03 23:41:52 +02:00
.forgejo/workflows Fix CI build (vendor patches). 2026-09-26 14:43:53 +02:00
actor-macro v0.6.0 2026-09-15 15:14:56 +02:00
assets Logo correction. 2026-09-06 22:46:09 +02:00
livewire Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
livewire-app Clean up media download source, cache path and URL handling 2026-09-26 22:12:42 +02:00
livewire-core Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
livewire-crypto Begin immediate on storing omemo stuff. 2026-09-24 15:39:10 +02:00
livewire-data Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
livewire-file-transfer Integrate MAM range catch-up. 2026-09-13 21:42:27 +02:00
livewire-jingle Complete Jingle S5B interoperability rung 2026-09-09 09:46:33 +02:00
livewire-proto Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
livewire-push Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
livewire-session Handle channel posts with no body in push notifications. 2026-09-27 12:16:04 +02:00
po Linkify URI-less things that look like JIDs. 2026-09-25 22:42:43 +02:00
qml Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
qml-sfos Show cached media as local on chat load and key the download cache by URL 2026-09-26 22:01:24 +02:00
rpm Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
screenshots Screenshots somehow got nuked during filter branch 2026-07-24 11:52:11 +02:00
scripts XEP-0170: Multi-lingual messages. 2026-09-14 11:46:25 +02:00
sfos Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
vendor XEP to md python script. 2026-09-22 21:46:23 +02:00
.codex Initial commit. 2026-06-17 16:07:15 +02:00
.dir-locals.el Initial commit. 2026-06-17 16:07:15 +02:00
.flake8 Initial commit. 2026-06-17 16:07:15 +02:00
.gitignore Vendor and build the MapLibre GL QML plugin under private Livewire names 2026-08-27 20:05:23 +02:00
.gitmodules Vendor and build the MapLibre GL QML plugin under private Livewire names 2026-08-27 20:05:23 +02:00
.isort.cfg Initial commit. 2026-06-17 16:07:15 +02:00
.python-version Initial commit. 2026-06-17 16:07:15 +02:00
.rustfmt.toml Initial commit. 2026-06-17 16:07:15 +02:00
AI_DISCLOSURE.md how stable is master? 2026-09-17 13:55:30 +02:00
bump.sh Fix bump.sh for Ubuntu Touch 2026-09-02 09:34:30 +02:00
Cargo.lock Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
Cargo.toml Merge master into jingle with disabled feature gate 2026-09-10 13:05:23 +02:00
CHANGELOG.md release notes 2026-09-15 15:39:27 +02:00
CHANNEL_TODO.md SFOS: stop unwinding the stack when a channel opens 2026-09-18 21:33:07 +02:00
CLAUDE.md Drop the stringly-typed exception from the style rules. 2026-09-24 15:05:13 +02:00
clickable.yaml Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
deny.toml Forgejo workflow. 2026-09-24 21:12:58 +02:00
doap.xml Reset OMEMO2 sessions. 2026-09-24 11:40:10 +02:00
libervia-to-xmpprs-todo.md Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
LICENSE Initial commit. 2026-06-17 16:07:15 +02:00
livewire-contenthub.json Initial commit. 2026-06-17 16:07:15 +02:00
livewire.apparmor XEP-0080 location sharing 2026-08-27 10:57:57 +02:00
livewire.desktop Complete Jingle transfer UX rung 7 2026-09-09 19:23:21 +02:00
livewire.dispatcher link fixes 2026-07-06 23:56:59 +02:00
manifest.json v0.6.0 2026-09-15 15:14:56 +02:00
OMEMO_TRUST_PLAN.md Accept XEP-0450 trust messages from contacts 2026-09-22 14:27:43 +02:00
push.apparmor remove networking from push helper apparmor again 2026-08-04 16:31:57 +02:00
push.json Replace libervia with Rust backend. 2026-06-27 21:36:02 +02:00
README.md build docs 2026-09-17 11:59:53 +02:00
SAILFISH_PORT_CHECKLIST.md Replace Qt Multimedia recorder plugin with libpulse and hound 2026-09-26 21:21:16 +02:00
snapcraft.yaml Initial commit. 2026-06-17 16:07:15 +02:00
xep2md.py XEP to md python script. 2026-09-22 21:46:23 +02:00

Livewire

Livewire

XMPP Channel

An alpha-quality native XMPP client for Ubuntu Touch, written in Rust on top of tokio-xmpp and xmpp-parsers.

Features

  • OMEMO encryption: End-to-end encrypted messaging via OMEMO, supporting OMEMO 2 and OMEMO legacy (blind trust at the moment).
  • Private encrypted groups: Invite-only group chats that are always OMEMO-encrypted.
  • Public channels (MUCs): Join and participate in public XMPP group chats, with member lists, mentions, and whispers.
  • Rich messaging: Text, images, image galleries, video, voice messages, audio, documents, and stickers; replies; emoji reactions; message editing; delivery and read receipts with status indicators.
  • Message sync: Your conversations are synced between all logged-in devices via MAM history, and messages sent while offline are queued and delivered on reconnect.
  • Contacts & presence: Roster management, adding contacts, and blocking (XEP-0191).
  • Push notifications: Real push via the Livewire Push Service, with a background-run fallback when push is unavailable.
  • Account creation: In-band registration where the server supports it.
  • Media handling: Download, cache, and display images, video, and audio.
  • Mobile-data aware: Client State Indication when unfocused, data-usage tracking, and automatic reconnect on network switch.

Still To-Do

A list of things not currently implemented, that probably should be implemented:

  • Searching for public channels (channel directory)
  • Jingle
  • Voice/video calls (let's call that a streeeeetch goal)

Need Support?

There are two official support channels for Livewire:

  • The XMPP group: Best for questions, casual conversation or diagnosing issues.
  • The issue tracker: For verified or reproducible bug reports. Questions can also be asked here, but the general intent is to track features and defects there.

Build

Livewire targets two platforms: Ubuntu Touch (built with Clickable) and Sailfish OS (built in a container with the Sailfish SDK).

Ubuntu Touch

Prerequisites: Clickable ≥ 8.6.0

git clone --recurse-submodules https://git.agnos.is/projectmoon/livewire && cd livewire
clickable build --arch=arm64
clickable install

Sailfish OS

Prerequisites: docker or podman. The image is built from sfos/Dockerfile on top of Whisperfish's sailo-rs image, which carries a Rust toolchain new enough for this crate. The Sailfish UI lives in qml-sfos/ (Silica) and follows the Ubuntu Touch QML in qml/ in behavior; only the widgets differ.

sfos/build.sh                  # both arches
sfos/build.sh i486             # emulator only
sfos/build.sh aarch64          # device only
sfos/build.sh --prune i486     # drop older RPMs for that arch afterwards
sfos/deploy.sh                 # install onto a running emulator (ARCH=aarch64 for a device)

Built RPMs are placed in the RPMS/ directory. The cargo target directory is kept in a per-arch docker volume mounted at the build tree's target/, so rebuilds are incremental. Note that CARGO_BUILD_JOBS is pinned to 1: cargo deadlocks under scratchbox2 with more, so Sailfish OS builds are slow by design.

Credits

This app is heavily based on the work of Brenno Almeida on Greenline. The UI is exactly the same but yellow heavily based on Greenline, and the internals were gutted and replaced with a native Rust XMPP stack.

Livewire was originally bootstrapped on the Libervia project before the internals were rewritten in native Rust due to engineering constraints.

AI Development Disclosure

For full information, read AI_DISCLOSURE.md.

The development of this application was and is being bootstrapped by the use of various generative AI technologies and large language models (LLMs). These technologies are being used to accelerate the creation of Livewire, with the intent to bring the code to a stable, human-maintainable state. Changes generated by the language model are reviewed and tested manually by a professional human developer and by volunteer alpha/beta testers.

In short:

  • There is a defined software roadmap and architecure plan, which is being worked through methodically.
  • LLMs are used with the intention of bringing the code into line with a defined, human-maintainable software architecture.
  • The application is not "vibe coded," as such. There is a defined software engineering process and release process.
  • Underlying end-to-end encryption code is not created via LLMs.

For full information, read the AI_DISCLOSURE.md document.

License

Copyright (C) 2026 - present projectmoon

Copyright (C) 2025, 2026 Brenno Almeida (Greenline)

Copyright (C) 2023 - 2026 Lothar Ketterer (DeltaTouch for the emoji reaction picker)

Copyright (C) 2025, 2026 Ruben de Smet (actor macro, qmeta-async, and sailo-rs for the Sailfish application bootstrap)

Copyright (C) 2019 Olivier Goffart (MIT licence carried by sailo-rs and qmetaobject-rs)

Copyright (C) 2021 Mirian Margiani (Whisperfish for the Sailfish rounded-rectangle component)

Distributed under the AGPLv3 because the actor-macro makes it a "combined work" under the AGPL.


This program is free software: you can redistribute it and/or modify it under the terms of the Affero GNU General Public License version 3, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranties of MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.