⚡ 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. Disabled: Google killed the Tenor GIF API. |
| 🤩 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 GIF tab is currently disabled because Google killed the Tenor API. The implementation remains in the source tree so a sustainable provider can be integrated later. Read what happened.
📦 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
.AppImage from 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 unbind Super+V in 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):
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.
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)
评论