Phone Connect

Control your KDE Connect-paired phone from the Noctalia bar.

Plugin

Entry	Type	Id
icefish/phone-connect	plugin	—
bar	widget	icefish/phone-connect:bar
tile	shortcut	icefish/phone-connect:tile
details	panel	icefish/phone-connect:details
details_floating	panel	icefish/phone-connect:details_floating
details_widget	panel	icefish/phone-connect:details_widget
kde	service	icefish/phone-connect:kde

Usage

Add the bar widget and control-center tile from Settings, then click either to open the details panel.

Open panels from the shell:

noctalia msg panel-toggle icefish/phone-connect:details
noctalia msg panel-toggle icefish/phone-connect:details_floating
noctalia msg panel-toggle icefish/phone-connect:details_widget

Send IPC events to the service:

noctalia msg plugin icefish/phone-connect:kde all refresh
noctalia msg plugin icefish/phone-connect:kde all cmd '{"op":"ring","device":"<id>"}'

Features

• Device status — battery level, charging state, network type (5G/LTE), pairing
• Quick actions — ring, ping, send clipboard, share text/files/URLs, SMS, SFTP browser
• Media control — play/pause/skip/seek, album art, now-playing (MPRIS)
• Customization — per-device image and alias, three panel placements
• Language — English / Simplified Chinese

Requirements

• kdeconnect — KDE Connect daemon and CLI
• gdbus — ships with glib2
• sshfs — optional, for phone file browsing

Settings

Setting	Default	Description
State Update Interval	30	Seconds between device refreshes
Show Charging Fill	true	Highlight bar widget when charging
Show Clipboard Action	true	Show clipboard button in panel
Device Image	—	Custom image for selected device
Device Alias	Your-Phone	Custom display name
Language	en	English / 简体中文
Panel Placement	attached	Attached / Floating center / Below widget

IPC

Event	Payload	Description
refresh	—	Full device refresh
cmd	JSON {"op":"…","device":"…"}	Execute an operation

Supported ops: ring, ping, clipboard, share_text, share_url, share_file, pair, accept, reject, unpair, browse, sms_send, launch_sms_app, media, media_seek, select, refresh, set_image.

Notes

• Communicates with KDE Connect via DBus (gdbus call) and CLI (kdeconnect-cli)
• Persists user preferences to pluginDataDir()/state.json
• No external network requests; all logic runs locally