README.md

Gnome Clipboard History

Gnome Clipboard History is a clipboard manager GNOME extension that saves what you've copied into an easily accessible, searchable history panel.

The extension is a rewrite of Clipboard Indicator with vastly improved performance, new features, and bug fixes.

A technical overview is available at https://alexsaveau.dev/blog/gch.

Project status: replaced by Ringboard

Gnome Clipboard History is now in maintenance mode as it is being replaced by Ringboard. I'm still accepting PRs for small improvements and bug fixes (such as supporting the latest Gnome version), but no new development will take place.

Download

Tips

• Open the panel from anywhere with Super + Shift + V.
• Modify shortcuts in settings or delete them by hitting backspace while editing a shortcut.
• Use the Only save favorites to disk feature to wipe your non-favorited items on shutdown.
• Use Private mode to temporarily stop processing copied items.
• Use keyboard shortcuts while the panel is open:
  • Ctrl + N where N is a number from 1 to 9 to select the Nth non-favorited entry.
  • Super + Ctrl + N where N is a number from 1 to 9 to select the Nth favorited entry.
  • Ctrl + p/n to navigate to the previous/next page.
  • Ctrl + Alt + S to open settings.
  • / to search.
  • F to (un)favorite a highlighted item.
• Search uses case-insensitive regex.

Install from source

A note on versioning:

• The master branch and 1.4.x tags support GNOME 45.
• The pre-45 branch and 1.3.x (or earlier) tags support GNOME 40-44.

Build

cd ~/.local/share/gnome-shell/extensions/ && \
  git clone https://github.com/SUPERCILEX/gnome-clipboard-history.git clipboard-history@alexsaveau.dev && \
  cd clipboard-history@alexsaveau.dev && \
  make

Restart GNOME

Alt + F2 then type r.

Install

gnome-extensions enable clipboard-history@alexsaveau.dev