mirror of
https://github.com/gustavosett/Windows-11-Clipboard-History-For-Linux
synced 2026-04-25 17:15:35 +02:00
ae7bdfe86a
* fix(clipboard): improve linux reliability - Implemented robust text and HTML setting using xclip and wl-copy - Added fallback to arboard for better compatibility on Linux distros - Updated package-lock.json with peer dependency metadata * refactor(clipboard): remove unused variables - Clean up unused variables to resolve compiler warnings - Remove redundant system clipboard initialization in paste_item * fix(clipboard): improve linux external tool handling - Added target OS guards to prevent executing Linux-specific commands on other platforms - Enhanced error reporting by capturing stderr when external tools like xclip or wl-copy fail - Updated HTML clipboard logic to attempt setting both HTML and plain text formats sequentially" * fix(linux): improve multi-format clipboard copy - Ensure plain text is set robustly after HTML content on Wayland and X11 - Prevents potential race conditions or overwrites when using external tools * fix(clipboard): explicitly set UTF-8 targets to prevent mojibake on browsers Browsers strictly enforce X11/Wayland clipboard target MIME types and atoms. When clipboard data is set with `text/plain`, browsers default to decoding it as ISO-8859-1 or ASCII, which breaks special characters, icons, and emojis such as kaomoji (e.g. they show as `ðð§(｡â¥â¿â¥ï½¡)`). This commit resolves the mojibake issue on Linux by: - Explicitly appending `;charset=utf-8` to the target when using `wl-copy`. - Explicitly using the `UTF8_STRING` atom instead of `text/plain` for `xclip` to conform with X11 conventions.
Windows 11 Clipboard History For Linux
Website • Report Bug • Request Feature
The aesthetic, feature-rich clipboard manager your Linux desktop deserves.
⚡ Quick Start (Recommended)
Get up and running in seconds. This script detects your distro, installs the app, and configures permissions automatically.
# Just copy and paste this into your terminal
curl -fsSL https://raw.githubusercontent.com/gustavosett/Windows-11-Clipboard-History-For-Linux/master/scripts/install.sh | bash
Note: No logout required! The installer uses ACLs to grant immediate access.
🌟 Why use this?
Most Linux clipboard managers are purely functional but lack visual appeal. This project brings the modern, fluid design of Windows 11's clipboard history to the Linux ecosystem, backed by the blazing speed of Rust.
| 😎 | 🔍 |
|---|---|
| 🐧 Universal Support | Works flawlessly on both Wayland & X11. |
| ⚡ Instant Access | Opens instantly with Super+V or Ctrl+Alt+V. |
| 🧠 Smart Positioning | The window follows your mouse cursor across multiple monitors. |
| 📌 Pin & Sync | Pin important snippets to keep them at the top. |
| 🎬 GIF Integration | Search Tenor and paste GIFs directly into Discord, Slack, etc. |
| 🤩 Emoji Picker | A built-in, searchable emoji keyboard. |
| 🛡️ Privacy First | Your history is stored locally. No data leaves your machine. |
⌨️ Shortcuts & Usage
| Key | Action |
|---|---|
| Super + V | Open Clipboard History |
| Ctrl + Alt + V | Alternative Shortcut |
| Enter | Paste Selected Item |
| Esc | Close Window |
Pro Tip: Need to paste a GIF? Just select it! The app simulates
Ctrl+Vto paste the file URI directly into your chat apps.
📦 Detailed Installation
Prefer to install manually? We support all major distributions.
Debian / Ubuntu / Mint / Pop!_OS
Recommended: Use the APT repository for automatic updates.
# 1. Add Repository
curl -1sLf 'https://dl.cloudsmith.io/public/gustavosett/clipboard-manager/setup.deb.sh' | sudo -E bash
# 2. Install
sudo apt update && sudo apt install win11-clipboard-history
# 3. Grant Permissions (One-time)
sudo setfacl -m u:$USER:rw /dev/uinput
Fedora / RHEL / CentOS
# 1. Add Repository
curl -1sLf 'https://dl.cloudsmith.io/public/gustavosett/clipboard-manager/setup.rpm.sh' | sudo -E bash
# 2. Install
sudo dnf install win11-clipboard-history
# 3. Grant Permissions (One-time)
sudo setfacl -m u:$USER:rw /dev/uinput
Arch Linux (AUR)
# Using yay
yay -S win11-clipboard-history-bin
# Or using paru
paru -S win11-clipboard-history-bin
AppImage (Universal)
Some features are disabled; we strongly recommend the complete installation.
- Download the
.AppImagefrom Releases. - Make it executable:
chmod +x win11-clipboard-history_*.AppImage - Grant permissions:
sudo setfacl -m u:$USER:rw /dev/uinput - Register the command that you want in your system to open the AppImage
KEYBOARD SETTINGS -> SHORTCUTS -> NEW SHORTCUT -> Super+V -> ./my_awesome_folder/win11-clipboard-history.AppImage
🔧 Troubleshooting
Shortcut (Super+V) isn't working
- Ensure the app is running:
pgrep -f win11-clipboard-history-bin - If running, try resetting the config:
rm ~/.config/win11-clipboard-history/setup.json
win11-clipboard-history
- Conflicts: GNOME and other DEs often reserve
Super+V. The app's Setup Wizard usually fixes this, but you can manually unbindSuper+Vin your system keyboard settings.
Transparency Issues (NVIDIA / AppImage)
If you see a black background or flickering, use the compatibility mode:
# Force NVIDIA workaround
IS_NVIDIA=1 win11-clipboard-history
# Force AppImage workaround
IS_APPIMAGE=1 win11-clipboard-history
🛠️ For Developers
Want to hack on the code?
Tech Stack: Rust + Tauri v2 + React + Tailwind CSS + Linux
# 1. Clone
git clone https://github.com/gustavosett/Windows-11-Clipboard-History-For-Linux.git
cd Windows-11-Clipboard-History-For-Linux
# 2. Install Deps
make deps && make rust && make node
source ~/.cargo/env
# 3. Run Dev Mode
make dev
✨ Contributors
Thanks goes to these wonderful people (emoji key):
 freshCoder21313 🔣 💻 🎨 |
 Tallin-Boston-Technology 🤔 |
 rorar 🤔 🐛 |
 sonarx 🤔 |
 Oleksandr Romaniuk 🐛 |
 Predrag 💻 🐛 |
 Hen 🐛 💻 |
 Eyad 🐛 💻 |
 Kinou 🐛 💻 💬 🎨 |
|||||
Add your contributions
|
||||||
Like this project?
Package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.