OmaConnect

Control your phone and other devices from the Omarchy bar with KDE Connect.

KDE Connect is the cross-device layer underneath. It pairs your Linux desktop with Android, iPhone, Windows, and macOS devices for clipboard sharing, file transfer, messaging, and notifications. OmaConnect puts the most useful controls in one quick bar panel instead of making you open a separate app.

Install

omarchy plugin add https://github.com/jitendradara12/omaconnect.git --enable --yes

Features

• Device status: Battery charge, charging state, cellular network type, signal strength, and reachability.
• Device actions: Ring phone, sync clipboard, send files, share text or links, and send pings.
• SMS launcher: Open kdeconnect-sms for a paired device.
• File picker: Select recent files from user directories with Omarchy's menu picker.
• Remote commands: View and trigger commands defined on paired devices.
• Pairing controls: Pair and unpair devices with inline confirmation safeguards.
• Modular preferences: Toggle specific actions, telemetry fields, or panel sections to match your workflow.

Preferences and configuration

You can customize OmaConnect via your Omarchy bar widget settings. All options default to true unless noted otherwise.

Option	Type	Default	Description
showBatteryStats	boolean	true	Display battery percentage and charging indicator
showNetworkStats	boolean	true	Display cellular network type and signal strength
showDeviceTypeIcons	boolean	true	Display device type icons (phone, tablet, laptop, desktop)
showRemoteCommands	boolean	true	Display remote commands section
showTroubleshooting	boolean	true	Display setup and firewall helpers when devices are offline
showActionRing	boolean	true	Include the Ring action button
showActionClipboard	boolean	true	Include the Clipboard sync button
showActionFile	boolean	true	Include the File send button
showActionSms	boolean	true	Include the SMS launcher button
showActionPing	boolean	false	Include the Ping button
showActionText	boolean	true	Include the Text and link sharing button
defaultPingMessage	string	""	Default draft text for ping composer

Security and permissions

OmaConnect does not run arbitrary commands or download unverified scripts.

• Dependency installation: The installer helper uses your system's package manager (pacman). It displays the exact command (sudo pacman -S --needed kdeconnect glib2 dbus) and asks for confirmation before requesting root privileges.
• Firewall setup: The firewall helper detects UFW or firewalld, displays the exact rules before applying them, and prompts for confirmation before running sudo.
• UI tooltips: Hovering over troubleshooting buttons displays the exact command that will execute.

Shortcuts

Add to ~/.config/omarchy/shortcuts.lua:

o.bind("SUPER + SHIFT + C", "Toggle OmaConnect", "omarchy-shell shell toggle omaconnect")

Dependencies

Requires kdeconnect, glib2, dbus, and Omarchy's omarchy-menu-select command for file sharing.

To install dependencies manually:

sudo pacman -S --needed kdeconnect glib2 dbus

Firewall configuration

Omarchy blocks incoming ports by default. Allow KDE Connect discovery and transfer ports:

Click Allow in Firewall inside the panel, or run manually:

For UFW:

sudo ufw allow 1714:1764/tcp comment 'KDE Connect'
sudo ufw allow 1714:1764/udp comment 'KDE Connect'
sudo ufw reload

For firewalld:

sudo firewall-cmd --permanent --add-service=kdeconnect
sudo firewall-cmd --reload

Update

omarchy plugin update omaconnect

Uninstall

omarchy plugin remove omaconnect