kdeconnect-cli

List all devices

$ kdeconnect-cli [[-l|--list-devices]]

$ kdeconnect-cli --list-available

$ kdeconnect-cli --pair --device [device_id]

$ kdeconnect-cli --ring --name "[device_name]"

$ kdeconnect-cli --share [url|path/to/file] --device [device_id]

$ kdeconnect-cli --name "[device_name]" --send-sms "[message]" --destination [phone_number] --attachment [path/to/file]

$ kdeconnect-cli --name "[device_name]" --unlock

$ kdeconnect-cli --name "[device_name]" --send-keys [key]

kdeconnect-cli [--device=ID | --name=NAME] command [args]

--device, -d ID
    Target specific device by ID

--name, -n NAME
    Target device by name (alternative to ID)

--list-devices, --list, -l
    List all known/paired devices with IDs

--list-available-devices, --available, -a
    List discoverable devices for pairing

--pair, -p
    Pair with a discoverable device (enter PIN)

--unpair
    Unpair the target device

--reject-pairing
    Reject incoming pairing request

--ping
    Send connectivity ping to device

--ping-ip IP
    Ping device by IP address

--info, --device-info, -i
    Show detailed device information

--lock, --lockscreen
    Lock the device screen remotely

--unlock, --unlock-screen
    Unlock the device screen remotely

--request-password [--visible]
    Request password input from device

--request-number [--visible]
    Request number input from device

--request-string [--visible]
    Request string/text input from device

--request-click
    Simulate mouse click on device

--request-mousemove x y
    Simulate mouse move on device

--request-keys keys
    Type keys on device

--request-mediakeys keys
    Press media keys on device

--share text
    Share text to device clipboard

--send-file path...
    Send one or more files to device

--battery-charging-start
    Notify device battery charging started

--battery-charging-stop
    Notify device battery charging stopped

--battery-low percentage
    Notify device of low battery level

--ring
    Ring device with notification sound

--ring-call
    Ring device as incoming call

--stop-ring
    Stop notification ring

--stop-ring-call
    Stop call ring

--find-my-phone
    Ring device until user acknowledges

--telephony
    Show telephony/call status

--bluetooth-status
    Show Bluetooth status on device

--help
    Show command help

--help-all
    Show all options

--version, -v
    Show version information

KDE Connect enables communication between Linux desktops (especially KDE Plasma) and mobile devices like Android phones over local Wi-Fi. Features include file sharing, notification syncing, clipboard sharing, remote control, media playback control, and finding your phone by ringing it.

kdeconnect-cli is the command-line interface to KDE Connect, allowing terminal-based interaction with paired devices. It depends on the kdeconnectd daemon running in the background.

Use it to list paired or discoverable devices, pair/unpair, send pings for connectivity checks, transfer files, lock/unlock screens, request user input (passwords, text), simulate keyboard/mouse input, ring the phone for location, share telephony status, and more. Device selection uses --device=ID (from --list-devices) or --name=NAME.

Ideal for scripts, automation, headless setups, or quick actions without the GUI app. Security relies on pairing with PIN confirmation; operates on ports 1714-1764 UDP/TCP.

Requires kdeconnectd daemon running; devices must be on same Wi-Fi network; pairing uses 6-digit PIN; firewall must allow ports 1714-1764 UDP/TCP; not encrypted end-to-end.

kdeconnect-cli --list-devices
kdeconnect-cli --device=123456 --ring
kdeconnect-cli --send-file ~/photo.jpg
kdeconnect-cli --name=MyPhone --lockscreen

Always run --list-devices first to get 6-character hex ID like ABC123; use with --device for commands.

KDE Connect launched in 2013 by Albert Vaka for KDE Plasma; kdeconnect-cli introduced early for scripting. Evolved with Plasma 5/6 integrations, adding telephony, input simulation; now cross-platform with Android app.

kdeconnectd(8), kdeconnect-settings(1)