Skip to content

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 (phones, tablets, laptops, desktops)
  • SMS Messaging - View conversations, reply, and compose new messages with contact lookup; open MMS photo and video attachments
  • Smart SMS Threading - Automatically merges conversations that iOS reaction-over-SMS splits into multiple threads on Android, with a one-click toggle to view them split
  • 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

SMS Reaction-Thread Merging

When someone reacts to an SMS from iOS, Android often files the reaction into a separate thread from the original conversation. Connected detects these split threads and merges them on the desktop side, with a one-click toggle to switch between merged and split views. Merging is on by default and recommended: besides reuniting the conversation, it routes your replies so the recipient receives a single copy. With merging off, replying in a split thread can deliver duplicate copies. Only use the split view if the merge heuristic ever combines conversations it shouldn't.

Split view Merged view
Split conversation view Merged conversation view

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

Install Connected from the Applets section of the COSMIC Store.

Alternatively, you can download the latest release from the Releases page and use the following instructions.

Flatpak

Install:

flatpak install --user ./cosmic-ext-connected_*.flatpak

Uninstall:

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

Debian/Ubuntu (.deb)

Install:

sudo apt install ./cosmic-ext-connected_*_amd64.deb

Uninstall:

sudo apt remove 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
just install

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

Uninstall:

just uninstall

If you previously installed via sudo just install, run sudo just uninstall-system once to clear the old system copy.

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

Notification settings live on the Notifications page, opened from the notifications icon at the top of the applet. You can toggle each desktop alert and tune what it reveals:

  • SMS notifications - Desktop alerts for incoming SMS, with options to show or hide the sender and the message content
  • Call notifications - Desktop alerts for incoming and missed calls, with options to show or hide the caller's name and number
  • File notifications - Desktop alerts for received files

App and version information is on the About page, reached from the identity line at the bottom of the device list.

Duplicate notifications with KDE Connect

Connected raises its own desktop notifications for incoming SMS and calls. KDE Connect can announce the same events independently, so depending on which KDE Connect plugins you have enabled, you may see each SMS or call notified twice. (File transfers are only notified by Connected, so they never duplicate.)

  • SMS - The duplicate comes from KDE Connect's "Receive notifications" plugin, which mirrors your phone's notifications to the desktop. Disabling that plugin stops the duplicate SMS toast, but it also empties Connected's per-device notification list and the notification count badge - both are populated from that plugin's data. Connected's own SMS toast is separate and keeps working either way.
  • Calls - The duplicate comes from KDE Connect's telephony plugin. Connected reads call events from that same plugin, so disabling it would remove Connected's call notifications too; there is no clean per-app toggle today.

The cleanest fix would be to mute KDE Connect's toasts at the COSMIC notification service. As COSMIC's notification settings evolve, per-application controls may offer a built-in way to do this.

Contributing

Contributions welcome! Please submit issues and pull requests.

See docs/ and CLAUDE.md for development documentation.

License

GNU General Public License v3.0 - see LICENSE.

Acknowledgments

About

COSMIC desktop applet for phone connectivity via KDE Connect

Resources

Stars

16 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages