Windows-11-Clipboard-History-For-Linux

---

⚡ 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.

1. Download the .AppImage from 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:

rm ~/.config/win11-clipboard-history/setup.json
win11-clipboard-history

1. 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):

freshCoder21313

Tallin-Boston-Technology

rorar

sonarx

Oleksandr Romaniuk

Predrag

Hen

Eyad

Kinou

Thomas

Axell Padilla

      Add your contributions