https://github.com/jaggzh/xclipview-tui
Review X11 Clipboard Contents from Terminal
https://github.com/jaggzh/xclipview-tui
Last synced: 3 months ago
JSON representation
Review X11 Clipboard Contents from Terminal
- Host: GitHub
- URL: https://github.com/jaggzh/xclipview-tui
- Owner: jaggzh
- License: gpl-3.0
- Created: 2025-07-29T08:00:50.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-07-29T08:54:25.000Z (11 months ago)
- Last Synced: 2025-07-29T10:50:26.329Z (11 months ago)
- Language: Python
- Size: 94.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - clipboard-viewer - Terminal-based clipboard browser. (<a name="copy-paste"></a>Copy/paste and clipboard)
- awesome-cli-apps - clipboard-viewer - Terminal-based clipboard browser. (<a name="copy-paste"></a>Copy/paste and clipboard)
README
# clipboard-viewer
A terminal-based clipboard browser that treats your copy-paste buffer with the dignity it deserves. Because sometimes you need to know *exactly* what's lurking in there, and `xclip -o` just isn't ceremonious enough.
(Did it in pytnon for now.)
Overview snapshot showing clipboard navigation and content preview
## What It Does
- Browse clipboard, primary, and secondary X11 selections
- Navigate available MIME targets (because yes, your clipboard has opinions about data formats)
- Preview text content
- View images directly in the terminal via [chafa](https://hpjansson.org/chafa/) (your ASCII art dreams, realized; although my chafa's defaulting to sixel or whatever atm)
- Vim-style navigation because some things are just correct
## Installation
```bash
# Dependencies
sudo apt install xclip imagemagick chafa # Debian/Ubuntu
sudo pacman -S xclip imagemagick chafa # Arch
brew install xclip imagemagick chafa # macOS (via Homebrew)
# Then just download and run (or `chmod u+x` it first)
./xclipview
```
## Usage
| Key | Action |
|-----|--------|
| `h`/`l` or `←`/`→` | Switch between clipboard selections |
| `j`/`k` or `↑`/`↓` | Navigate target list |
| `Enter` | View images with chafa |
| `r` | Reload current selection |
| `q` | Quit |
The interface splits into a target list (left) and content preview (right). Targets with no data appear grayed out with a `?` prefix—they're the clipboard equivalent of "it's complicated."
Image viewing mode with chafa integration
## Why This Exists
Standard clipboard tools show you *what* you copied. This shows you *how* your system thinks about what you copied. Sometimes that distinction matters. Sometimes you're just procrastinating. Either way, you're covered.
## Requirements
- Python 3.6+
- X11 environment (sorry, Wayland friends—patches welcome)
- A terminal that can handle basic Unicode (so, any terminal from this millennium)
## License
MIT. Copy freely, paste responsibly.