Find and paste anything you copied earlier, with one shortcut.
A cozy, paper-themed clipboard history that remembers your text, links, colors, code and images.
Features · Install · Shortcuts · Settings · Contribute
The real Clipio panel: open it, move with the arrow keys, type to search, change settings.
| System | Versions | Opens with | Automatic paste |
|---|---|---|---|
| Windows | 10 and 11 | Ctrl Shift V | Yes |
| macOS | Apple Silicon and Intel | ⌘ ⇧ V | Yes |
| Linux X11 | any desktop | Super V | Yes |
| Linux Wayland | Hyprland, Sway, KDE, GNOME | a key you choose (see Linux Wayland below) | Yes (GNOME: copy only) |
| System | File | First time only |
|---|---|---|
| Windows | Clipio-Setup.exe |
If SmartScreen appears: More info → Run anyway |
| macOS | Clipio-macOS-AppleSilicon.dmg or …-Intel.dmg |
Right-click Clipio → Open; allow it under Privacy & Security → Accessibility |
| Linux | Clipio-Setup-Linux |
Or paste the command below into a terminal |
curl -fsSL https://github.com/ardazeybek/clipio/releases/latest/download/install.sh | shClipio looks for a new version when it starts and once a day. It downloads it, checks it against a checksum, and installs it quietly while the panel is closed. You'll see a small "Clipio was updated" note. Turn it off in Settings → Features → Automatic updates, or check right away with clipio update.
| System | How |
|---|---|
| Windows | Settings → Apps → Clipio → Uninstall |
| macOS / Linux | run clipio uninstall |
Your history and settings are kept, in case you come back.
Install with Python (for developers)
Needs Python 3.10–3.14. On Linux also wl-clipboard (Wayland) or xdotool (X11).
pipx install git+https://github.com/ardazeybek/clipio.git
clipio start
clipio autostart onPython installs don't update themselves; Clipio tells you when a new version is out (pipx upgrade clipio).
| Key | Action |
|---|---|
| ↑ ↓ · PgUp PgDn | Move |
| Enter · click | Paste |
| Shift + Enter | Paste cleaned (no tracking, tidy spaces) |
| Ctrl + C | Copy only |
| Ctrl + E | Edit, then paste |
| Ctrl + M · right click | Card menu |
| Ctrl + P | Pin or unpin |
| Ctrl + Space · Ctrl + click | Add to the paste queue |
| Alt + 1…9 | Paste one of the first nine |
| Del | Delete |
| Tab · Shift + Tab | Next / previous tab |
| Esc | Clear the search, then close |
| Ctrl + , | Settings |
Every in-panel shortcut can be changed in Settings → Shortcuts. Clicking outside the panel closes it.
Open them with the gear button or Ctrl + ,:
Settings file (config.toml)
| System | Settings file | History |
|---|---|---|
| Windows | %APPDATA%\clipio\config.toml |
%LOCALAPPDATA%\clipio\ |
| macOS | ~/Library/Application Support/clipio/config.toml |
same folder |
| Linux | ~/.config/clipio/config.toml |
~/.local/share/clipio/ |
| Setting | What it does | Default |
|---|---|---|
retention_days |
Days before unpinned items are deleted | 14 |
max_items |
Most items to keep | 500 |
max_text_kb / max_image_mb |
Larger texts / images are not saved | 1024 / 25 |
max_images_total_mb |
Total size limit for images | 1024 |
persist |
Put the last item back when the source app empties the clipboard | true |
hotkey |
Global shortcut, e.g. "ctrl+alt+v" |
per system |
ignore_apps |
Apps never recorded, e.g. ["KeePassXC"] |
[] |
clean_links |
Remove tracking parameters from links | true |
secret_minutes |
Minutes before secrets are deleted | 5 |
link_titles |
Fetch page titles of links (visits the site) | false |
auto_update |
Install new versions by itself | true |
panel_keep_minutes |
Minutes the closed panel stays ready (0 = free at once, 1440 = always) |
5 |
Run clipio stop and clipio start after editing the file by hand.
Linux Wayland
Wayland doesn't let apps grab global shortcuts, so bind clipio toggle to a key yourself:
| Desktop | How |
|---|---|
| Hyprland | bind = SUPER, V, exec, clipio toggle in hyprland.conf |
| Sway | bindsym $mod+v exec clipio toggle |
| GNOME / KDE | Settings → Keyboard → Custom shortcut with the command clipio toggle |
Pasting works on Hyprland out of the box and with wtype on Sway and other wlroots desktops (the installer fetches it). On GNOME, Clipio copies the item and you paste with Ctrl + V.
macOS permissions
macOS asks once for:
- Accessibility — so Clipio can paste into other apps.
- Input Monitoring — for the global shortcut.
Allow Clipio under System Settings → Privacy & Security. Without Accessibility, picking an item still copies it and you paste with ⌘ + V.
Command line
clipio help lists everything. The handy ones:
clipio toggle # open or close the panel
clipio next # paste the next item of the paste queue
clipio pause # stop recording (clipio resume to continue)
clipio retention 7 # keep items for 7 days
clipio update # look for a new version now
clipio status # is it running, how many items
clipio start / stop # start or quit Clipio
clipio uninstall # remove the app (history stays)How it works (for developers)
Clipio is two small processes written in Python with a Qt Quick (QML) interface through PySide6:
| Part | When it runs | Memory |
|---|---|---|
| Recorder — clipboard, saving, pasting, hotkey, tray, updates | always | ≈ 25 MB of its own |
| Panel — the window you see | while you use it, plus a few minutes | freed completely when it quits |
| Folder | Role |
|---|---|
clipio/core/ |
Classifies and stores items (SQLite), applies limits — no OS code |
clipio/system/ |
One small backend per platform: clipboard, paste, hotkey, autostart, updates |
clipio/setup/ |
The installer of the ready-made app |
clipio/ui/ |
The panel and setup windows in QML |
packaging/ |
Builds the installers (PyInstaller) on every release |
Run it from source:
git clone https://github.com/ardazeybek/clipio.git && cd clipio
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e ".[test]"
clipio run # Ctrl+C stops itMAP.md maps the whole architecture; every folder has its own README.md. The tests run on Windows, macOS and Linux with Python 3.10–3.14 on every push.
Bug reports, testing on other desktops, translations, docs and design ideas are all welcome — see CONTRIBUTING.md.
Free and open source under the MIT License.
⭐ If Clipio saves you time, a star on GitHub helps other people find it.

