Native XMPP client for Ubuntu Touch and Sailfish OS.
  • Rust 75.8%
  • QML 23.5%
  • Shell 0.4%
  • Python 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
projectmoon 0bf36ccb41
All checks were successful
Test Livewire / license-check (push) Successful in 1m49s
Test Livewire / native-tests (push) Successful in 10m4s
Test Livewire / qt-tests (push) Successful in 14m48s
Build Livewire / Clickable armhf (push) Successful in 31m1s
Build Livewire / Clickable amd64 (push) Successful in 32m18s
Build Livewire / Clickable arm64 (push) Successful in 32m27s
Build Livewire / clickable (push) Successful in 0s
Don't process mention candidates on every keystroke (????)
2026-10-22 21:10:32 +02:00
.cargo Enforce omemo in private groups. 2026-07-03 23:41:52 +02:00
.forgejo/workflows Manual CI trigger 2026-10-09 12:43:02 +02:00
actor-macro Bump version to 0.7.4 2026-10-17 08:25:01 +02:00
assets Ubuntu Touch: new logo, launcher uses PNG. 2026-10-11 12:18:25 +02:00
ci SFOS CI 2026-10-09 08:23:44 +02:00
livewire Don't process mention candidates on every keystroke (????) 2026-10-22 21:10:32 +02:00
livewire-app Channel posting tool 2026-10-20 11:16:21 +02:00
livewire-core Push helper: rejoin queued rooms until the budget runs out, like process-pending 2026-10-20 16:25:34 +02:00
livewire-crypto Bump version to 0.7.4 2026-10-17 08:25:01 +02:00
livewire-data Push helper: room catch-up saves where it got to and resumes there 2026-10-20 19:04:12 +02:00
livewire-file-transfer section 1 2026-09-10 16:15:11 +02:00
livewire-jingle Complete Jingle S5B interoperability rung 2026-09-09 09:46:33 +02:00
livewire-proto Use MDS to dismiss answered auth requests. 2026-10-20 09:16:20 +02:00
livewire-push Push helper: smaller rejoin reserve, log full error chains 2026-10-20 20:01:32 +02:00
livewire-session Use MDS to dismiss answered auth requests. 2026-10-20 09:16:20 +02:00
po Channel posting tool 2026-10-20 11:16:21 +02:00
qml Don't process mention candidates on every keystroke (????) 2026-10-22 21:10:32 +02:00
qml-sfos Don't process mention candidates on every keystroke (????) 2026-10-22 21:10:32 +02:00
rpm Package channel_tool for Sailfish and Ubuntu Touch 2026-10-20 11:31:24 +02:00
screenshots Screenshots somehow got nuked during filter branch 2026-07-24 11:52:11 +02:00
scripts Allow UTF8 JIDs 2026-10-08 14:45:53 +02:00
sfos sfos 32 bit 2026-10-06 10:54:34 +02:00
vendor Allow UTF8 JIDs 2026-10-08 14:45:53 +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 sfos 32 bit 2026-10-06 10:54:34 +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 Update deps 2026-10-20 21:40:34 +02:00
Cargo.toml sfos 32 bit 2026-10-06 10:54:34 +02:00
CHANGELOG.md Final v0.7.4 2026-10-21 10:53:47 +02:00
CHANNEL_TODO.md SFOS: stop unwinding the stack when a channel opens 2026-09-18 21:33:07 +02:00
CLAUDE.md SFOS: Show why push might not be available. 2026-09-29 21:23:33 +02:00
clickable.yaml Package channel_tool for Sailfish and Ubuntu Touch 2026-10-20 11:31:24 +02:00
deny.toml Forgejo workflow. 2026-09-24 21:12:58 +02:00
doap.xml doap 2026-09-30 15:42:54 +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 Ubuntu Touch: new logo, launcher uses PNG. 2026-10-11 12:18:25 +02:00
livewire.dispatcher link fixes 2026-07-06 23:56:59 +02:00
manifest.json Bump version to 0.7.4 2026-10-17 08:25:01 +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 fix readme features 2026-10-09 14:45:19 +02:00
rust-analyzer.toml Make rust-analyzer use system gettext so cancelled checks stop leaking gettext builds into /tmp 2026-10-19 12:07:47 +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, presence, and adding and blocking contacts (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: Downloads and caches attachments for offline viewing.
  • 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.

Sailfish OS

For Sailfish OS, the official release channel is OpenRepos.

The latest and pre-release versions are also available via Harpoon. Scan this code in Harpoon's scanner, or open the link on your phone.

Add to Harpoon

harpoon://add?url=https%3A%2F%2Fgit.agnos.is%2Fprojectmoon%2Flivewire&source=Forgejo

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/.