https://github.com/cosmic-utils/kdeconnect
https://github.com/cosmic-utils/kdeconnect
Last synced: 13 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/cosmic-utils/kdeconnect
- Owner: cosmic-utils
- License: gpl-3.0
- Created: 2025-11-07T15:00:43.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-05-23T16:58:30.000Z (13 days ago)
- Last Synced: 2026-05-23T18:25:06.404Z (13 days ago)
- Language: Rust
- Size: 731 KB
- Stars: 46
- Watchers: 7
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
⚠️ WORK IN PROGRESS
A native KDE Connect implementation for the COSMIC Desktop, written in Rust.
Many features are working but you may encounter bugs — please report them via GitHub Issues.
---
✅ Supported Features
- Device Pairing / Unpairing
- Battery Monitor
- Clipboard Sync (bidirectional)
- Connectivity Report (signal strength / network type)
- Contacts Sync
- Find My Phone
- MPRIS / Media Control (exposed via D-Bus MPRIS2 to COSMIC panel)
- Notifications (receive, action, reply)
- Ping
- Run Commands
- Share Files & URLs (send files, receive files and URLs)
- SMS (conversations, send/receive)
- Plugin Enable / Disable per device
- System Volume (Partial support - May not work on certain devices - Known Mobile App Bug)
- Telephony (Know bug - Media does not resume when Ending/Canceling Call)
🚧 Features Not Yet Supported
- MousePad / Remote Input
- Presenter Mode
- SFTP / Browse Device
- Virtual Display
---
## Installing from [COSMIC Flatpak Repository](https://github.com/pop-os/cosmic-flatpak)
```bash
flatpak remote-add --if-not-exists --user cosmic https://apt.pop-os.org/cosmic/cosmic.flatpakrepo
flatpak install --user io.github.hepp3n.kdeconnect
```
---
## Building from Source
### Prerequisites
- [rustup.rs](https://rustup.rs)
- `libxkbcommon-dev` (required on some distros — if the build fails, install this first)
- [`just`](https://github.com/casey/just) command runner
### Quick Start
```bash
git clone https://github.com/hepp3n/kdeconnect.git
cd kdeconnect
just build
just install
```
The service starts automatically on next login via D-Bus activation and XDG autostart.
### Optional: Systemd Integration
For journalctl logging and `systemctl` control instead of D-Bus activation:
```bash
just install-systemd
just enable-service
```
> **Note:** You may need to log out and back in for the applet to appear in the COSMIC panel.
> Once logged back in, go to **COSMIC Settings → Desktop → Panel → Configure Panel Applets** and add KDE Connect.
### Debug Install
Full logging for both the service and panel applet:
```bash
just install-debug
```
- Service logs → `/tmp/kdeconnect-service.log`
- Applet logs → `/tmp/kdeconnect-applet.log`
Restore to standard install with `just install`.
---
## Uninstalling
```bash
just uninstall
```
---
## Building as Flatpak
Requires `flatpak-builder`:
```bash
flatpak-builder --force-clean --user --install-deps-from=flathub --repo=repo --install builddir io.github.hepp3n.kdeconnect.json
```
## Troubleshooting
Some distributions enables Firewall by default. Or you are enabled it by yourself.
In this case, check what firewall you are using. And allow 1714-1764 port range for TCP and UDP connections.
For UFW firewall:
```bash
sudo ufw allow 1714:1764/udp
sudo ufw allow 1714:1764/tcp
sudo ufw reload
```
For Firewalld:
```bash
sudo firewall-cmd --permanent --zone=home --add-service=kdeconnect
sudo firewall-cmd --reload
```
For IPTables:
```bash
sudo iptables -I INPUT -i -p udp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -I INPUT -i -p tcp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o -p udp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o -p tcp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
```
For more, directly from official KDEConnect userbase: [KDEConnect Firewall](https://userbase.kde.org/KDEConnect#ufw)