CSY2569andGitHub
c3f96b59e7
* 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
76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
# 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
|