v1.17: live tier-3 path enabled — Ctrl+V uses flashpaste-trigger

User-facing change: the tmux + kitty example snippets now invoke
`flashpaste-trigger` (Rust, ~5ms round-trip) as the primary handler
for Ctrl+V and right-click → Paste. The bash dispatch script remains
as an automatic fallback when the daemon socket is missing:

  flashpaste-trigger '%pane' 2>/dev/null || tmux-paste-dispatch.sh '%pane'

This is fully backward compatible:
- daemon running → tier-3 (~5ms)
- daemon down   → tier-1 (~120ms bash)

The user's live tmux.conf + kitty.conf were patched in place so the
new path is active immediately (no restart needed beyond tmux source-
file, which was done).

Measured on the dev box: flashpaste-trigger round-trip = 5ms
(vs bash dispatch ~120ms FAST PATH; ~3s including all timeouts).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: NagyVikt

bin/clipboard-set.sh

@@ -64,17 +64,20 @@ if [ -n "${WAYLAND_DISPLAY:-}" ] && command -v wl-copy >/dev/null 2>&1; then
       kill -TERM "$_prev" 2>/dev/null
     fi
   fi
-  wl-copy <"$_tmp"
-  rc=$?
-  # wl-copy default-daemonizes — parent exits, the surviving daemon
-  # holds the clipboard. pgrep -n returns the newest matching pid,
-  # which is the daemon we just spawned (races with another concurrent
-  # caller are tolerable: worst case we reap someone else's wl-copy
-  # next time, identical to what the janitor already does).
-  _new=$(pgrep -u "$(id -u)" -n -x wl-copy 2>/dev/null)
-  [ -n "$_new" ] && printf '%s\n' "$_new" > "$_pidfile" 2>/dev/null
-  clog "clipboard-set" "event=done" "backend=wl-copy" "rc=$rc" "pid=${_new:-?}"
-  exit $rc
+  # IMPORTANT: wl-copy does NOT auto-daemonize on this box (man wl-copy:
+  # "stays in the foreground until the clipboard contents change"). The
+  # v1.14 janitor reaps wl-copy >3s old, so any synchronous `wl-copy`
+  # call here would exit 143 (SIGTERM) ~3s after we returned — except
+  # we already exited rc=$? from the foreground process, so tmux's
+  # run-shell binding shows "...clipboard-set.sh' returned 143" in the
+  # pane. Fix: explicitly background wl-copy, record its pid, and exit
+  # 0. wl-copy lives until janitor reap; clipboard contents stay set.
+  setsid wl-copy <"$_tmp" >/dev/null 2>&1 &
+  _new=$!
+  disown 2>/dev/null || true
+  printf '%s\n' "$_new" > "$_pidfile" 2>/dev/null
+  clog "clipboard-set" "event=done" "backend=wl-copy" "rc=0" "pid=${_new}"
+  exit 0
 fi
 if [ -n "${DISPLAY:-}" ] && command -v xclip >/dev/null 2>&1; then
   clog "clipboard-set" "event=backend-chosen" "backend=xclip"

examples/kitty.conf.snippet

@@ -7,12 +7,14 @@
 # text paste. For images, use Ctrl+Alt+V which sends a raw \026 byte
 # via `kitty @ send-text` so the inner TUI gets the keystroke directly.
 
-# Ctrl+V → text paste through kitty's clipboard action.
-map ctrl+v       launch --type=background --copy-env -- ~/paste_image.sh
+# Ctrl+V → tier-3 path through flashpasted daemon (~5ms round-trip).
+# paste_image.sh stays as the fallback when the daemon socket is missing
+# (e.g. before `systemctl --user start flashpasted.service`).
+map ctrl+v       launch --type=background --copy-env -- sh -c 'flashpaste-trigger "$(tmux display-message -p "#{pane_id}" 2>/dev/null)" 2>/dev/null || ~/paste_image.sh'
 
-# Ctrl+Alt+V → image paste. Sends raw Ctrl-V byte to focused window;
-# flashpaste's wl-paste shim then delivers the image bytes from xclip
-# when the inner TUI reads the clipboard.
+# Ctrl+Alt+V → force the legacy image-paste path (sends raw Ctrl-V via
+# kitty @ send-text). Useful when the daemon is intentionally disabled
+# or when debugging xclip ownership.
 map ctrl+alt+v   launch --type=background --copy-env -- ~/paste_image.sh image
 
 # Optional: bind PrtScr to GNOME's screenshot UI (file lands in

examples/tmux.conf.snippet

@@ -19,17 +19,20 @@ bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "sh -c '#{@clip}'"
 bind -n DoubleClick1Pane select-pane \; copy-mode -M \; send-keys -X select-word \; send-keys -X copy-pipe-no-clear "sh -c '#{@clip}'"
 bind -n TripleClick1Pane select-pane \; copy-mode -M \; send-keys -X select-line \; send-keys -X copy-pipe-no-clear "sh -c '#{@clip}'"
 
-# C-v in any normal pane → flashpaste dispatch (image branch + text branch).
-bind -n C-v run-shell -b "TMUX_PASTE_TRIGGER=ctrl-v /home/$USER/.local/bin/tmux-paste-dispatch.sh '#{pane_id}'"
+# C-v in any normal pane → flashpaste tier-3 path. flashpaste-trigger
+# is a 5-ms Rust client that pings the flashpasted daemon over a unix
+# socket; if the daemon isn't running it falls back to the bash
+# dispatch script. Same handler covers text paste AND image paste.
+bind -n C-v run-shell -b "TMUX_PASTE_TRIGGER=ctrl-v flashpaste-trigger '#{pane_id}' 2>/dev/null || TMUX_PASTE_TRIGGER=ctrl-v /home/$USER/.local/bin/tmux-paste-dispatch.sh '#{pane_id}'"
 
 # Middle-click paste from system clipboard.
 bind -n MouseDown2Pane run-shell -b "buf=$(sh -c '#{@paste}'); if [ -n \"$buf\" ]; then printf '%s' \"$buf\" | tmux load-buffer -b mid_paste - 2>/dev/null && tmux paste-buffer -d -p -b mid_paste -t '#{pane_id}' 2>/dev/null; fi"
 
-# Right-click pane menu with Paste item.
+# Right-click pane menu with Paste item — same tier-3 trigger path.
 bind -n MouseDown3Pane display-menu -O -x M -y M \
   -T "#[align=centre,fg=#FFFFFF,bold] pane #{pane_index} " \
   "#[fg=#34C759]↳ Paste" p \
-    "run-shell -b \"/home/$USER/.local/bin/tmux-paste-dispatch.sh '#{pane_id}'\""
+    "run-shell -b \"flashpaste-trigger '#{pane_id}' 2>/dev/null || /home/$USER/.local/bin/tmux-paste-dispatch.sh '#{pane_id}'\""
 
 # Recursion-guard note: the C-v binding above intentionally re-invokes
 # the dispatcher when kitty `send-text` injects a \026 byte. The

packaging/build-deb.sh

@@ -74,10 +74,13 @@ fi
 # (or the postinst can symlink it to $HOME/paste_image.sh per user — handled below).
 install -m 0755 "$REPO_DIR/bin/paste_image.sh" "$STAGE/usr/share/flashpaste/paste_image.sh"
 
-# Desktop entries.
-install -m 0644 "$REPO_DIR/share/applications/wl-clipboard.desktop" "$STAGE/usr/share/applications/"
-install -m 0644 "$REPO_DIR/share/applications/wl-paste.desktop"     "$STAGE/usr/share/applications/"
-install -m 0644 "$REPO_DIR/share/applications/wl-copy.desktop"      "$STAGE/usr/share/applications/"
+# Desktop entries — glob every *.desktop under share/applications/ so new
+# entries (e.g. org.flashpaste.daemon.desktop matching the flashpasted
+# daemon's Wayland app_id) ship without a build-script edit.
+for desk in "$REPO_DIR"/share/applications/*.desktop; do
+  [ -f "$desk" ] || continue
+  install -m 0644 "$desk" "$STAGE/usr/share/applications/"
+done
 
 # systemd user units.
 install -m 0644 "$REPO_DIR/systemd/clipboard-janitor.service"               "$STAGE/usr/lib/systemd/user/"