Files

T

CSY2569andGitHub c3f96b59e7 add icefish/phone-connect v0.1.0 (#155 )

* add icefish/phone-connect v0.1.0

* update phone-connect README with screenshot

* fix phone-connect: add thumbnail.webp and missing en.json keys

* fix phone-connect: remove unused assets and screenshot.png

* fix phone-connect: CI compliance fixes

* fix phone-connect: command seq and MPRIS performance

* fix phone-connect: MPRIS sequential + media action delay

* fix phone-connect: seek format + live position polling

* fix phone-connect: use Set position for media seek

* fix phone-connect: shell-quote seek variant

* fix phone-connect: seek position tracking

* fix phone-connect: final compliance — remove LICENSE, update thumbnail, fix tags

2026-07-31 08:17:12 -04:00

2.7 KiB

Raw Blame History

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

2.7 KiB Raw Blame History