punix/wirepy-touch
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
92 commits 1 branch 0 tags 14 MiB
Find a file
Exact
Désiré Werner Menrath 7e68e4efa9 fix(security): remove accidental export zip, update clickable.yaml, sanitize run.sh and add export validation
2026-10-12 22:52:53 +02:00
assets Initial push mit Universal-gitignore 2026-10-04 21:17:32 +02:00
ext/ZBarScannerPlugin fix: remove qr code log in zbarscanner and fix edit tunnel saving logic 2026-10-03 13:43:47 +02:00
po feat: add German, French, and Italian translations for new strings 2026-10-03 19:38:14 +02:00
qml style: move export all button to top main row alongside import and stop buttons 2026-10-04 20:08:32 +02:00
screenshots docs: release 1.2.0 with updated README, changelog and screenshots 2026-10-04 18:36:39 +02:00
src fix(security): remove accidental export zip, update clickable.yaml, sanitize run.sh and add export validation 2026-10-12 22:52:53 +02:00
.gitignore fix(security): remove accidental export zip, update clickable.yaml, sanitize run.sh and add export validation 2026-10-12 22:52:53 +02:00
CHANGELOG.md docs: release 1.2.0 with updated README, changelog and screenshots 2026-10-04 18:36:39 +02:00
clickable.yaml fix(security): remove accidental export zip, update clickable.yaml, sanitize run.sh and add export validation 2026-10-12 22:52:53 +02:00
CMakeLists.txt feat: replace QZXing entirely with a native ZBar C++ QML plugin to guarantee robust, lightning-fast barcode decoding 2026-10-03 10:23:24 +02:00
content-hub.json chore: initial commit with i18n, build cleanup, and version bump to 1.0.9 2026-10-02 15:08:04 +02:00
forgejo-push Initial push mit Universal-gitignore 2026-10-04 21:17:32 +02:00
manifest.json docs: release 1.2.0 with updated README, changelog and screenshots 2026-10-04 18:36:39 +02:00
README.md docs: document bulk export feature 2026-10-04 20:21:54 +02:00
run.sh fix(security): remove accidental export zip, update clickable.yaml, sanitize run.sh and add export validation 2026-10-12 22:52:53 +02:00
update_version.py chore: initial commit with i18n, build cleanup, and version bump to 1.0.9 2026-10-02 15:08:04 +02:00
wirepy-touch.apparmor feat: replace useless background notification with audio signal and app launcher badge 2026-10-04 16:29:59 +02:00
wirepy-touch.desktop fix: add qml to qmlscene import paths for QZXing 2026-10-02 16:31:48 +02:00

README.md

Wirepy Touch

Wirepy Touch is a lightweight, native graphical user interface for Ubuntu Touch (Lomiri) designed to seamlessly import, manage, and control WireGuard connections (VPN tunnels).

This app communicates directly with the system's native NetworkManager (nmcli), completely eliminating the need for additional containers, complex Polkit configurations, or background services for basic operation. It provides a fast, simple, and direct solution for importing existing .conf files and switching between VPN connections with a single tap.

System Requirements

  • OS: Ubuntu Touch (Lomiri)
  • Minimum Version: Ubuntu 20.04 (Focal Fossa) or newer
  • Dependencies: wireguard-tools, network-manager

Features

  • Effortless Import: Simply select a WireGuard .conf file from your Documents or Downloads folder. The app automatically parses the configuration, cleans up incompatibilities, and adds it directly to NetworkManager.
  • Robust IPv6 Handling: Automatically resolves IPv6 DNS leak bugs in NetworkManager by injecting an IPv6 dummy address (fd00::1) if necessary when editing or importing profiles.
  • Fast Switching: A clean list displays all your imported tunnels. One tap is all it takes to activate a tunnel. Any previously active tunnels are safely and automatically disconnected beforehand.
  • Reliable Autostart: Easily set a tunnel to automatically connect on system boot. Wirepy Touch uses native systemd user services to ensure your VPN is always up when you need it, and confirms successful connection with a discreet audio chime (Positive.ogg).
  • Dynamic Launcher Badge: The app's icon displays a "1" badge in the Lomiri launcher whenever a tunnel is active, providing quick visual confirmation of your VPN status.
  • Bulk Export: Export all your unencrypted tunnel configurations instantly into a single .zip archive to your Downloads folder for easy backup or migration.
  • Direct NM Integration: No complicated SSL integrations or background daemons—Wirepy Touch speaks directly to nmcli for robust performance.

Usage

  1. Import: Tap the Import button at the top and select a valid WireGuard .conf file.
  2. Start a Tunnel: Imported tunnels instantly appear in your list. Tap an entry to start it. The active tunnel is highlighted in green (or blue, depending on your theme).
  3. Stop: Tap the Stop button at the top to immediately close the active tunnel.
  4. Export All: Tap the Export button at the top to zip all your tunnel configs into ~/Downloads.
  5. Autostart: Tap the checkbox at the bottom of the screen to set the currently active tunnel to start automatically on your next device reboot.

Technical Details

  • UI Framework: QML (Lomiri Components 1.3)
  • Backend: Python 3 via PyOtherSide
  • Networking: nmcli (NetworkManager) & systemd

Compiling & Running

To develop or manually install the app, clickable is required.

# Build the click package and launch it directly on the connected device:
clickable

Screenshots

A project crafted for Ubuntu Touch.