ClipFlow Pro

ClipFlow Pro is a clipboard history manager for GNOME Shell (UUID clipflow-pro@nickotmazgin.github.io).

Latest: v1.5.1 — Fixes X11 clipboard polling CPU spike (native St.Clipboard first; no more gjs+xclip on every poll). Previous releases are kept for history; download only from Releases.

GNOME Shell 43–44 is no longer supported. ClipFlow Pro now targets GNOME 45–50 only. Upgrade your desktop environment to GNOME 45 or newer.

Keywords: GNOME clipboard manager · Linux clipboard history · Wayland clipboard · history window · copy paste · productivity · privacy · open source

---

Screenshots

Main collage

v1.4.2 highlights

History window	Panel / recent clips	Settings → Behavior	Settings → Shortcuts	About → Maintenance

Full combined image (download): collage-v1.4.2-2026.jpg

---

What's new in v1.5.1

• X11 CPU fix: clipboard monitoring no longer spawns clipboard-read-runner.js + xclip every 500 ms when xclip is installed; native St.Clipboard is used first
• System responsiveness: fixes Shell lag and pointer delay caused by constant GJS subprocess churn on X11 desktops

Also in v1.5.0

• Reliable auto-insert: multiline, emoji, and long clips paste as one block via clipboard (not keystroke simulation)
• Screenshot-safe: ignores clipboard churn while screenshot tools are focused
• Privacy: export files 0600, notification previews off by default, better token detection
• Context menu: Insert and Insert + Enter on history rows

Also in v1.4.9

• Safe disable/upgrade: an in-flight clipboard read can no longer throw TypeError: this._clipboard is null when the extension is disabled mid-read, which previously left the extension INACTIVE until the session restarted

Also in v1.4.8

• Clean Shell journal: removed an invalid stylesheet rule that logged a warning on every panel icon repaint (no visual change)
• Hardened release CI: stylesheet and translation changes now always run the required release-validation check
• Credits: new Credits & Acknowledgements section and CONTRIBUTORS.md

Also added in v1.4.7

• Faster insertion: redundant fixed waits were removed from panel and History Window paste paths
• Responsive History Window: clipboard and keyboard helpers run asynchronously outside its UI process
• Backlog-free monitoring: only one native read per clipboard selection can be active at a time
• Bounded recovery: stalled clipboard owners cannot leave reads pending indefinitely
• Zorin/X11 fallback: a short-lived helper reads modern UTF-8 clipboard targets when St.Clipboard exposes none
• Faster history sync: 100 ms persistence and 50 ms History Window refresh debounces
• Reliable capability detection: get_text-only and get_content-only Shell implementations are supported
• Privacy-safe diagnostics: operational failures are visible without recording clipboard contents

Also added in v1.4.6

• No GNOME Shell freeze: clipboard ownership and keyboard insertion run in short-lived helper processes
• Paste follows focus: the active app at paste time wins; the previously captured app is only a fallback
• Terminal-aware paste: kitty, GNOME/Zorin Terminal, Ghostty, WezTerm, and other terminals use Ctrl+Shift+V or Shift+Insert, never raw Ctrl+V
• Stale target repair: closed or replaced windows are rejected before insertion
• Test coverage: X11 integration smoke tests exercise real kitty and GNOME Terminal windows

Also added in v1.4.3

• Reliable paste into agent terminals (Codex, Cursor Agents, etc.): plain-text clipboard via xclip/wl-copy plus direct keystroke typing when Ctrl+V is treated as image paste
• History window insert captures and restores the target app window; panel menu and history window now behave the same
• ESM-safe paste helpers (no broken imports load in GNOME Shell)

What's new in v1.4.2

• History Window header: labeled Settings and About buttons (opens preferences on the right tab)
• About → Maintenance: confirm dialog before Reset to Defaults, with success toast
• History Window: multi-select checkbox delete removes all selected entries
• Panel menu: Delete row under each recent clip (right-click panel icon)
• Shortcuts: Open Recent Clips Menu, Paste Latest, Paste Previous, Classic filters/toggles
• README / screenshots: refreshed 2026 collage and highlight gallery

What's new in v1.4.1 (important)

History Window + insert workflow upgrades

A dedicated desktop window for browsing, searching, and managing clipboard history:

• Left-click the panel icon → opens the History Window (default)
• Super+Shift+H → same window
• Search, scroll, timestamps, pin/star markers
• Copy, Insert, Insert + Enter, Pin, Star, Delete, Clear all, Refresh
• Stays in sync with the panel menu via ~/.config/clipflow-pro/history.json
• Requires gjs (GNOME JavaScript) — included on Zorin/Ubuntu/Fedora GNOME

Panel interactions

Action	Result
Left-click	History Window (full list)
Right-click	Recent clips menu with Show more / Show less paging

Also in v1.4.1

• GNOME 46 settings window: proper close button and Adw layout
• Rendering mode consolidated under General → Menu & Rendering (Auto / Classic)
• Right-click recent-clip menu now applies full copy + insert behavior
• Added Enable Auto Insert (xdotool / wtype) setting for copy-only fallback
• Show more/less no longer closes the menu unexpectedly
• Removed deprecated Super+Shift+V quick-menu shortcut path
• Numeric-style fixes: ESM-safe extension paths, scrollable enhanced menu on GNOME 45+

Full changelog

---

Compatibility

GNOME	Status	Notes
45–50	Supported	History Window, ESM, enhanced panel menu — use *-gs45-50.zip
43–44	Discontinued	No longer built, distributed, or maintained

Minimum requirement: GNOME Shell 45 or newer.

• Panel icon position: left / center / right on the GNOME top bar (not bottom/side docks)
• Distribution: GitHub Releases only (no extensions.gnome.org)

---

Install

From GitHub (recommended)

1. Download clipflow-pro@nickotmazgin.github.io-*-gs45-50.zip from Releases (GNOME 45–50 only).
2. Install:

gnome-extensions install --force clipflow-pro@nickotmazgin.github.io-1.5.1-gs45-50.zip
gnome-extensions enable clipflow-pro@nickotmazgin.github.io
# Alt+F2 → r → Enter

Local build

./build.sh && ./install.sh
# Alt+F2 → r → Enter

---

Quick Start

1. Copy something — it appears in history
2. Left-click panel icon → History Window
3. Right-click panel icon → recent clips + shortcuts
4. Settings → General → Menu & Rendering (Auto recommended)

Features

• Pinned / Starred sections, content-type detection
• Export / Import, purge duplicates, password filtering
• Pause monitoring, clear on lock/logout
• Keyboard shortcuts (Settings → Shortcuts)

---

Links

• Releases: https://github.com/nickotmazgin/clipflow-pro/releases
• Issues: https://github.com/nickotmazgin/clipflow-pro/issues
• Changelog: CHANGELOG.md

More GNOME extensions by Nick Otmazgin

• Numeric Clock — DD/MM/YYYY 24-hour top-bar clock with seconds
• Comfort Control (EaseHub) — panel menu for power, screenshots, updates & utilities

---

Credits & Acknowledgements

ClipFlow Pro is created, maintained, signed, and released by Nick Otmazgin — the project's sole administrator and solo developer, who authors and reviews all code that ships.

Recent releases were built with help from AI pair-programming agents, operated under the maintainer's direction and review:

• OpenAI Codex — clipboard capture/persistence performance work, terminal paste reliability, release engineering, signing, and validation
• Cursor (Agent) — code review, debugging, automated testing workflows, and documentation

Every AI-assisted change is human-reviewed, tested on real GNOME sessions, and approved by the maintainer before release. See CONTRIBUTORS.md for the full credits.

OpenAI and Codex are trademarks of OpenAI. Cursor is a trademark of Anysphere, Inc. These names are used here solely for factual attribution. ClipFlow Pro is an independent project and is not affiliated with, sponsored, or endorsed by OpenAI or Anysphere/Cursor.

---

Support