Release v1.20.0: zero-idle wake-ups + kcd source package

.github/workflows/ci.yml

@@ -116,7 +116,10 @@ jobs:
   integration-test:
     name: Integration Tests
     runs-on: ubuntu-latest
-    if: github.event_name == 'push'
+    # Runs on pull_request too. `push` is scoped to main/master, so a
+    # feature branch only ever fires the pull_request event — gating on
+    # push alone meant integration never ran before merge.
+    if: github.event_name == 'push' || github.event_name == 'pull_request'
     needs: test
     steps:
       - uses: actions/checkout@v4

.goreleaser.yaml

@@ -2,6 +2,10 @@ version: 2
 
 project_name: kcd
 
+# Source tarball for the AUR source package (aur_sources pipe).
+source:
+  enabled: true
+
 before:
   hooks:
     - go mod tidy
@@ -110,6 +114,57 @@ aurs:
 
       install -Dm644 "./LICENSE" "${pkgdir}/usr/share/licenses/kcd-bin/LICENSE"
 
+aur_sources:
+  - name: kcd
+    homepage: "https://github.com/bethropolis/kcd"
+    description: |
+      Lightweight, headless implementation of the KDE Connect protocol (v8) written in Go
+    maintainers:
+      - "bethropolis <bethropolis at gmail dot com>"
+    license: "MIT"
+    private_key: "{{ .Env.AUR_KEY }}"
+    skip_upload: true
+    git_url: "ssh://[email protected]/kcd.git"
+    provides:
+      - kcd
+    conflicts:
+      - kcd-bin
+    makedepends:
+      - go
+    depends:
+      - glibc
+    optdepends:
+      - "libnotify: for desktop notifications"
+      - "wl-clipboard: for Wayland clipboard sync"
+      - "xclip: for X11 clipboard sync"
+      - "sshfs: for SFTP mounting support"
+      - "python-nautilus: for Nautilus file manager integration"
+      - "ydotool: for Wayland mousepad support"
+      - "xdotool: for X11 mousepad support"
+      - "wtype: for Wayland keyboard emulation"
+    build: |-
+      export CGO_ENABLED=0
+      go build -trimpath -ldflags "-s -w -X main.version=${pkgver} -X main.commit={{.Commit}} -X main.date={{.Date}}" -o kcd ./cmd/kcd
+    package: |-
+      install -Dm755 "./kcd" "${pkgdir}/usr/bin/kcd"
+
+      install -Dm644 "./packaging/kcd-pkg.service" "${pkgdir}/usr/lib/systemd/user/kcd.service"
+      install -Dm644 "./packaging/kcd-pkg.socket" "${pkgdir}/usr/lib/systemd/user/kcd.socket"
+      install -Dm644 "./packaging/kcd-system.service" "${pkgdir}/usr/lib/systemd/system/[email protected]"
+
+      install -Dm644 "./packaging/kcd.example.toml" "${pkgdir}/usr/share/doc/kcd/kcd.example.toml"
+      install -Dm644 "./README.md" "${pkgdir}/usr/share/doc/kcd/README.md"
+      install -Dm644 "./LICENSE" "${pkgdir}/usr/share/licenses/kcd/LICENSE"
+
+      install -Dm644 "./packaging/kcd.bash-completion" "${pkgdir}/usr/share/bash-completion/completions/kcd"
+      install -Dm644 "./packaging/kcd.zsh-completion" "${pkgdir}/usr/share/zsh/site-functions/_kcd"
+      install -Dm644 "./packaging/kcd.fish-completion" "${pkgdir}/usr/share/fish/vendor_completions.d/kcd.fish"
+
+      install -Dm644 "./packaging/nautilus-kcd.py" "${pkgdir}/usr/share/nautilus-python/extensions/nautilus-kcd.py"
+
+      install -Dm644 "./packaging/firewalld-kcd.xml" "${pkgdir}/usr/lib/firewalld/services/kcd.xml"
+      install -Dm644 "./packaging/ufw-kcd" "${pkgdir}/etc/ufw/applications.d/kcd"
+
 dockers_v2:
   - images:
       - "ghcr.io/bethropolis/kcd"
@@ -262,6 +317,12 @@ release:
     systemctl --user enable --now kcd.socket
     ```
 
+    **Arch Linux source:**
+    ```bash
+    yay -S kcd
+    systemctl --user enable --now kcd.socket
+    ```
+
     **Debian / Ubuntu:**
     ```bash
     curl -LO https://github.com/bethropolis/kcd/releases/download/v{{ .Version }}/kcd_{{ .Version }}_x86_64.deb

AGENTS.md

@@ -105,6 +105,7 @@ error message may be confusing.
 | SystemVolume | `systemvolume.NewSystemVolumePlugin(bus *events.Bus, logger log.Logger) *SystemVolumePlugin` |
 | SMS | `sms.NewSMSPlugin(cfg config.SMSConfig, bus *events.Bus, tlsConfig *tls.Config, logger log.Logger) *SMSPlugin` |
 | Contacts | `contacts.NewContactsPlugin(bus *events.Bus, logger log.Logger) *ContactsPlugin` |
+| MPRIS | `mpris.NewMPRISPlugin(tlsConfig *tls.Config, bus *events.Bus, pauseMusic bool, mprisCfg config.MPRISConfig, logger log.Logger, cacheDirs ...string) *MPRISPlugin` |
 
 ### Interface
 

cmd/kcd/cli_battery.go

@@ -10,22 +10,23 @@ import (
 var batteryCmd = &cli.Command{
 	Name:      "battery",
 	Usage:     "Fetch battery level and charging status",
-	ArgsUsage: "<device-id>",
+	ArgsUsage: "[device-id]",
 	Flags: []cli.Flag{
 		&cli.BoolFlag{
 			Name:  "json",
 			Usage: "Output raw JSON",
 		},
 	},
 	Action: func(c *cli.Context) error {
-		if c.NArg() < 1 {
-			return fmt.Errorf("missing device ID")
-		}
 		cl, err := getClient(c)
 		if err != nil {
 			return err
 		}
-		charge, charging, err := cl.Battery(c.Args().First())
+		deviceID, err := resolveDeviceID(c, cl)
+		if err != nil {
+			return err
+		}
+		charge, charging, err := cl.Battery(deviceID)
 		if err != nil {
 			return err
 		}

cmd/kcd/cli_clipboard.go

@@ -6,7 +6,6 @@ import (
 	"os"
 	"os/exec"
 
-	"github.com/bethropolis/kcd/internal/device"
 	"github.com/urfave/cli/v2"
 )
 
@@ -31,25 +30,10 @@ var clipboardCmd = &cli.Command{
 			return err
 		}
 
-		var targetID string
-		if c.NArg() >= 1 {
-			targetID = c.Args().First()
-		} else {
-			devs, err := cl.Devices()
-			if err != nil {
-				return err
-			}
-			for _, d := range devs {
-				if d.Connected && d.State == device.StatePaired {
-					targetID = d.ID
-					break
-				}
-			}
-			if targetID == "" {
-				return fmt.Errorf("no paired connected devices found")
-			}
+		targetID, err := resolveDeviceID(c, cl)
+		if err != nil {
+			return err
 		}
-
 		if err := cl.ClipboardPush(targetID); err != nil {
 			return err
 		}

cmd/kcd/cli_connectivity.go

@@ -6,7 +6,6 @@ import (
 	"sort"
 	"strings"
 
-	"github.com/bethropolis/kcd/internal/device"
 	"github.com/bethropolis/kcd/internal/plugins/connectivity"
 	"github.com/urfave/cli/v2"
 )
@@ -27,21 +26,9 @@ var connectivityCmd = &cli.Command{
 			return err
 		}
 
-		targetID := c.Args().First()
-		if targetID == "" {
-			devs, err := cl.Devices()
-			if err != nil {
-				return err
-			}
-			for _, d := range devs {
-				if d.Connected && d.State == device.StatePaired {
-					targetID = d.ID
-					break
-				}
-			}
-			if targetID == "" {
-				return fmt.Errorf("no paired connected devices found")
-			}
+		targetID, err := resolveDeviceID(c, cl)
+		if err != nil {
+			return err
 		}
 
 		raw, err := cl.Connectivity(targetID)

cmd/kcd/cli_contacts.go

@@ -15,16 +15,17 @@ var contactsCmd = &cli.Command{
 		{
 			Name:      "sync",
 			Usage:     "Request a contacts sync from a device",
-			ArgsUsage: "<device-id>",
+			ArgsUsage: "[device-id]",
 			Action: func(c *cli.Context) error {
-				if c.NArg() < 1 {
-					return fmt.Errorf("missing device ID")
-				}
 				cl, err := getClient(c)
 				if err != nil {
 					return err
 				}
-				if err := cl.ContactsSync(c.Args().Get(0)); err != nil {
+				deviceID, err := resolveDeviceID(c, cl)
+				if err != nil {
+					return err
+				}
+				if err := cl.ContactsSync(deviceID); err != nil {
 					return err
 				}
 				fmt.Println("Contacts sync requested. Use `kcd watch --events contacts.updated` to see results.")
@@ -34,22 +35,23 @@ var contactsCmd = &cli.Command{
 		{
 			Name:      "list",
 			Usage:     "List cached contacts for a device",
-			ArgsUsage: "<device-id>",
+			ArgsUsage: "[device-id]",
 			Flags: []cli.Flag{
 				&cli.BoolFlag{
 					Name:  "json",
 					Usage: "Output raw JSON",
 				},
 			},
 			Action: func(c *cli.Context) error {
-				if c.NArg() < 1 {
-					return fmt.Errorf("missing device ID")
-				}
 				cl, err := getClient(c)
 				if err != nil {
 					return err
 				}
-				list, err := cl.ContactsList(c.Args().Get(0))
+				deviceID, err := resolveDeviceID(c, cl)
+				if err != nil {
+					return err
+				}
+				list, err := cl.ContactsList(deviceID)
 				if err != nil {
 					return err
 				}
@@ -72,16 +74,16 @@ var contactsCmd = &cli.Command{
 		{
 			Name:      "clear",
 			Usage:     "Delete cached contacts for a device (re-sync restores them)",
-			ArgsUsage: "<device-id>",
+			ArgsUsage: "[device-id]",
 			Action: func(c *cli.Context) error {
-				if c.NArg() < 1 {
-					return fmt.Errorf("missing device ID")
-				}
 				cl, err := getClient(c)
 				if err != nil {
 					return err
 				}
-				id := c.Args().Get(0)
+				id, err := resolveDeviceID(c, cl)
+				if err != nil {
+					return err
+				}
 				list, err := cl.ContactsList(id)
 				if err != nil {
 					return err

cmd/kcd/cli_device.go

@@ -0,0 +1,44 @@
+package main
+
+import (
+	"fmt"
+	"sort"
+	"strings"
+
+	"github.com/bethropolis/kcd/internal/device"
+	"github.com/bethropolis/kcd/pkg/client"
+	"github.com/urfave/cli/v2"
+)
+
+// resolveDeviceID returns the device a command should act on.
+//
+// An explicit argument always wins. Otherwise the sole paired, connected
+// device is selected, so the common single-phone setup needs no ID. With
+// several candidates it is an error naming them rather than a silent
+// coin flip against the wrong phone.
+func resolveDeviceID(c *cli.Context, cl *client.Client) (string, error) {
+	if c.NArg() >= 1 {
+		return c.Args().First(), nil
+	}
+
+	devs, err := cl.Devices()
+	if err != nil {
+		return "", err
+	}
+
+	var paired []string
+	for _, d := range devs {
+		if d.Connected && d.State == device.StatePaired {
+			paired = append(paired, d.ID)
+		}
+	}
+	switch len(paired) {
+	case 0:
+		return "", fmt.Errorf("no paired connected devices found — pass a device ID")
+	case 1:
+		return paired[0], nil
+	default:
+		sort.Strings(paired)
+		return "", fmt.Errorf("multiple devices connected (%s) — pass a device ID", strings.Join(paired, ", "))
+	}
+}