- Rust 75.8%
- QML 23.5%
- Shell 0.4%
- Python 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
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
|
||
| .cargo | ||
| .forgejo/workflows | ||
| actor-macro | ||
| assets | ||
| ci | ||
| livewire | ||
| livewire-app | ||
| livewire-core | ||
| livewire-crypto | ||
| livewire-data | ||
| livewire-file-transfer | ||
| livewire-jingle | ||
| livewire-proto | ||
| livewire-push | ||
| livewire-session | ||
| po | ||
| qml | ||
| qml-sfos | ||
| rpm | ||
| screenshots | ||
| scripts | ||
| sfos | ||
| vendor | ||
| .codex | ||
| .dir-locals.el | ||
| .flake8 | ||
| .gitignore | ||
| .gitmodules | ||
| .isort.cfg | ||
| .python-version | ||
| .rustfmt.toml | ||
| AI_DISCLOSURE.md | ||
| bump.sh | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| CHANNEL_TODO.md | ||
| CLAUDE.md | ||
| clickable.yaml | ||
| deny.toml | ||
| doap.xml | ||
| libervia-to-xmpprs-todo.md | ||
| LICENSE | ||
| livewire-contenthub.json | ||
| livewire.apparmor | ||
| livewire.desktop | ||
| livewire.dispatcher | ||
| manifest.json | ||
| OMEMO_TRUST_PLAN.md | ||
| push.apparmor | ||
| push.json | ||
| README.md | ||
| rust-analyzer.toml | ||
| SAILFISH_PORT_CHECKLIST.md | ||
| snapcraft.yaml | ||
| xep2md.py | ||
Livewire
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.
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/.
