# Windows 11 Clipboard History For Linux [Website](https://clipboard.gustavosett.dev) • [Report Bug](https://github.com/gustavosett/Windows-11-Clipboard-History-For-Linux/issues) • [Request Feature](https://github.com/gustavosett/Windows-11-Clipboard-History-For-Linux/discussions/new?category=ideas) **The aesthetic, feature-rich clipboard manager your Linux desktop deserves.** [![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE) [![Total Downloads](https://img.shields.io/endpoint?url=https://clipboard.gustavosett.workers.dev/&style=for-the-badge&logo=cloudsmith&logoColor=white)](https://broadcasts.cloudsmith.com/gustavosett/clipboard-manager) [![Tauri](https://img.shields.io/badge/Built_With-Tauri_v2-24C8D6?style=for-the-badge&logo=tauri&logoColor=white)](https://tauri.app/) [![Rust](https://img.shields.io/badge/Powered_By-Rust-000000?style=for-the-badge&logo=rust&logoColor=white)](https://www.rust-lang.org/) ![App Screenshot](https://github.com/user-attachments/assets/74400c8b-9d7d-49ce-8de7-45dfd556e256)

--- ## ⚡ Quick Start (Recommended) Get up and running in seconds. This script detects your distro, installs the app, and configures permissions automatically. ```bash # 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+V` to 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. ```bash # 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

```bash # 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)

```bash # 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. 1. Download the `.AppImage` from [Releases](https://github.com/gustavosett/Windows-11-Clipboard-History-For-Linux/releases). 2. Make it executable: `chmod +x win11-clipboard-history_*.AppImage` 3. Grant permissions: `sudo setfacl -m u:$USER:rw /dev/uinput` 4. 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

1. Ensure the app is running: `pgrep -f win11-clipboard-history-bin` 2. If running, try resetting the config: ```bash rm ~/.config/win11-clipboard-history/setup.json win11-clipboard-history ``` 3. **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: ```bash # 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`

```bash # 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](https://allcontributors.org/docs/en/emoji-key)):

_{freshCoder21313} 🔣 💻 🎨	_{Tallin-Boston-Technology} 🤔	_rorar 🤔 🐛	_sonarx 🤔	_{Oleksandr Romaniuk} 🐛	_Predrag 💻 🐛	_Hen 🐛 💻
_Eyad 🐛 💻	_Kinou 🐛 💻 💬 🎨
Add your contributions

# Like this project? give it a star

---

Package repository hosting is graciously provided by [Cloudsmith](https://cloudsmith.com). 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.