Skip to content
ardazeybekPublic

About

Paper-themed clipboard history for Windows, macOS and Linux: press a shortcut to find and paste anything you copied. Tiny background recorder, panel loads only when you need it. Python + Qt (PySide6), MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Clipio logo

Clipio

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.

Windows 10 and 11 macOS on Apple Silicon and Intel Linux on X11 and Wayland

Latest version Test status MIT license Free

Download Clipio

Features · Install · Shortcuts · Settings · Contribute

Clipio opening, moving through the cards with the arrow keys, searching for git and for a color, then showing the settings page

The real Clipio panel: open it, move with the arrow keys, type to search, change settings.


✨ Why Clipio?

One shortcut: pick a copy and it is pasted. Lovely to look at: a calm paper theme. Private: everything stays on your computer. Light: about 25 MB in the background. Updates itself, quietly. Everywhere: Windows, macOS and Linux.

💻 Works on

Download for Windows 10 and 11 Download for macOS, Apple Silicon and Intel Download for Linux, X11 and Wayland

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)

🌟 Features

Everyday: quick paste with Enter or a click; search and tabs; pins and folders that never expire; Alt + 1 to 9 pastes one of the first nine; a paste queue.

Smart cards: color swatches with HEX and RGB; colored code; clean links with optional page titles; image thumbnails and OCR (needs tesseract); the source app on each card, @app filters; edit and convert (case, JSON, Base64, URL); templates like {date}, {time}, {clipboard}.

Privacy: passwords, keys and card numbers are hidden and deleted after a few minutes; password managers and apps you choose are never recorded; pause with one click; old items are deleted after 1 to 30 days; everything stays in a small local database.

📥 Install

The easy way (recommended)

1. Download: the download page picks your system. 2. Open the file and press Install, no Python or admin rights needed. 3. That is it: Clipio starts now and with your computer.

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 | sh

Updates

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

Uninstall

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 on

Python installs don't update themselves; Clipio tells you when a new version is out (pipx upgrade clipio).

⌨️ Shortcuts

1. Copy as usual: Clipio keeps every copy. 2. Press the shortcut, then search or pick a card. 3. It is pasted right where you were typing.

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.

⚙️ Settings

Open them with the gear button or Ctrl + ,:

Settings tabs: How to, an animated guide per feature; Shortcuts, click a key and press the new one; Features, switch each one on or off; Storage, how long items are kept, how long the closed panel stays ready and ignored apps.

The Clipio settings page on the Storage tab

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 it

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

🤝 Contributing

Bug reports, testing on other desktops, translations, docs and design ideas are all welcome — see CONTRIBUTING.md.

💬 Support

Bugs and ideas: GitHub Issues Questions: GitHub Discussions Anything else: send an email

📜 License

Free and open source under the MIT License.


⭐ If Clipio saves you time, a star on GitHub helps other people find it.

About

Paper-themed clipboard history for Windows, macOS and Linux: press a shortcut to find and paste anything you copied. Tiny background recorder, panel loads only when you need it. Python + Qt (PySide6), MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages