support clipboard copy

Author: kan-bayashi

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "svt"
-version = "25.12.2"
+version = "25.12.3"
 edition = "2024"
 description = "Simple Viewer in Terminal - sxiv-like terminal image viewer"
 
@@ -15,3 +15,4 @@ flate2 = "1.0"
 serde = { version = "1", features = ["derive"] }
 toml = "0.8"
 dirs = "5"
+arboard = "3"

Cargo.toml

@@ -10,6 +10,7 @@ A minimal & fast terminal image viewer written in Rust with sxiv-like keybinding
 
 - **Fast** - Zlib compression, prefetch, and render cache for instant navigation
 - **Keyboard-driven** - sxiv/vim-like keybindings with count support
+- **Clipboard** - Copy path (OSC 52, works over SSH) or image to clipboard (local/X11 only)
 - **Flexible** - Fit/Normal display modes, works over SSH with Tmux
 - **KGP** - Kitty Graphics Protocol for high-quality image rendering
 
@@ -66,6 +67,8 @@ svt ~/photos/*.jpg
 | `G` | Last image |
 | `f` | Toggle fit |
 | `r` | Reload (clear cache) |
+| `y` | Copy path to clipboard (OSC 52, works over SSH) |
+| `Y` | Copy image to clipboard (local/X11 only) |
 | `q` | Quit |
 
 Vim-like counts are supported (e.g. `5j`, `10G`).

README.md

@@ -118,3 +118,27 @@ These invariants must be preserved when modifying the codebase:
 5. **Transmit must complete once started**
    - Skip cancellation during active transmission (`is_transmitting()`)
    - Ensures terminal receives complete image data
+
+## Clipboard Support
+
+`svt` provides two clipboard copy methods via `y` and `Y` keys:
+
+### Path Copy (`y` key)
+
+Uses **OSC 52** escape sequence to copy the image path as text:
+
+- Format: `\x1b]52;c;<base64>\x07`
+- Works over SSH (terminal interprets the sequence locally)
+- Tmux-aware: wraps in `\x1bPtmux;...\x1b\\` when `$TMUX` is set
+
+Implementation: `WriterRequest::CopyToClipboard` in `src/sender.rs`
+
+### Image Copy (`Y` key)
+
+Uses **arboard** crate to copy image data via OS clipboard API:
+
+- Converts image to RGBA and sends to system clipboard
+- Works on local machine and X11-forwarded SSH sessions
+- Does NOT work on headless SSH (no display server)
+
+Implementation: `copy_image_to_clipboard()` in `src/app.rs`

docs/architecture.md

@@ -517,6 +517,44 @@ impl App {
         });
     }
 
+    /// Copy the current image's absolute path to clipboard via OSC 52.
+    pub fn copy_path_to_clipboard(&self) -> bool {
+        let Some(path) = self.current_path() else {
+            return false;
+        };
+        let Some(path_str) = path.to_str() else {
+            return false;
+        };
+        self.writer.send(WriterRequest::CopyToClipboard {
+            data: path_str.as_bytes().to_vec(),
+            is_tmux: self.is_tmux,
+        });
+        true
+    }
+
+    /// Copy the current image data to clipboard (local only, uses OS API).
+    pub fn copy_image_to_clipboard(&self) -> bool {
+        use arboard::{Clipboard, ImageData};
+
+        let Some(path) = self.current_path() else {
+            return false;
+        };
+        let Ok(img) = image::open(path) else {
+            return false;
+        };
+        let rgba = img.to_rgba8();
+        let (width, height) = rgba.dimensions();
+        let image_data = ImageData {
+            width: width as usize,
+            height: height as usize,
+            bytes: rgba.into_raw().into(),
+        };
+        let Ok(mut clipboard) = Clipboard::new() else {
+            return false;
+        };
+        clipboard.set_image(image_data).is_ok()
+    }
+
     pub fn current_image_name(&self) -> String {
         self.images
             .get(self.current_index)