Skip to content

nwxnw/cosmic-ext-connected

Repository files navigation

Connected

A phone connectivity applet for the COSMIC desktop panel, powered by KDE Connect.

Connected applet showing device page

Features

  • Device Management - Pair, unpair, and monitor connected devices
  • SMS Messaging - View conversations, reply, and compose new messages with contact lookup
  • File Sharing - Send and receive files and URLs, with desktop notifications
  • Clipboard Sync - Send clipboard content to your device
  • Notifications - View and dismiss phone notifications; desktop alerts for SMS and calls (with privacy controls)
  • Battery Status - Monitor battery level and charging state
  • Media Controls - Control music playback (play/pause, next/previous, volume)
  • Find My Phone - Ring or ping your phone to locate it

Requirements

Connected requires KDE Connect on both your desktop and Android phone.

Desktop:

# Debian/Ubuntu/Pop!_OS
sudo apt install kdeconnect

# Fedora
sudo dnf install kdeconnect

# Arch
sudo pacman -S kdeconnect

Phone: Install the KDE Connect app from Google Play or F-Droid.

Installation

Download the latest release from the Releases page.

Debian/Ubuntu (.deb)

Install:

sudo apt install ./cosmic-ext-connected_0.3.0_amd64.deb

Uninstall:

sudo apt remove cosmic-ext-connected

Flatpak

Install:

flatpak install --user ./cosmic-ext-connected_0.3.0.flatpak

Uninstall:

flatpak uninstall --user io.github.nwxnw.cosmic-ext-connected

From source

Requires Rust, just, and system dependencies:

sudo apt install -y build-essential cmake pkgconf \
  libxkbcommon-dev libwayland-dev libglvnd-dev \
  libexpat1-dev libfontconfig-dev libfreetype-dev \
  libinput-dev libdbus-1-dev libssl-dev
just build-release
sudo just install

Then add Connected to your COSMIC panel via Settings > Desktop > Panel > Applets.

Uninstall:

sudo just uninstall

Usage

  1. Ensure both devices are on the same network
  2. Click the Connected applet in your panel - your phone should appear
  3. Click your phone and select "Pair", then accept on your phone
  4. Important: After pairing, enable the requested permissions in the KDE Connect app on your phone (SMS, Contacts, etc.)

Configuration

Settings are accessible via the gear icon in the applet. Options include:

  • Show battery percentage - Display battery level in device list
  • Show offline devices - Show paired devices that aren't currently connected
  • File notifications - Desktop notifications for received files
  • SMS notifications - Desktop notifications for incoming SMS (with sender/content privacy options)
  • Call notifications - Desktop notifications for incoming/missed calls (with name/number privacy options)

Contributing

Contributions welcome! Please submit issues and pull requests.

See CLAUDE.md for detailed development documentation.

License

GNU General Public License v3.0 - see LICENSE.

Acknowledgments

About

COSMIC desktop applet for phone connectivity via KDE Connect

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages