CopyQ
Clipboard manager with advanced features

CopyQ — Official Website
Quick Take: CopyQ
CopyQ is the most powerful clipboard manager available on macOS—the scripting engine, tabbed organization, and content processing capabilities are unmatched by any alternative, free or paid. The trade-off is a Qt interface that doesn't look native and a configuration process that requires more initial effort. For power users and developers who want to automate clipboard workflows, CopyQ is the clear choice. For users who want a simple, pretty clipboard history, Maccy or Paste are better fits. CopyQ earns 4.2 instead of 4.5 because the non-native interface and setup complexity create friction for casual users.
Best For
- •Developers and Power Users Who Want Clipboard Automation
- •Researchers Who Need Organized Clipboard History with Tabs
- •Cross-Platform Users Who Need the Same Clipboard Manager on Mac, Linux, and Windows
What is CopyQ?
CopyQ is an open-source clipboard manager that saves everything you copy and lets you search, edit, organize, and script your clipboard history. It's cross-platform (macOS, Linux, Windows) and packed with features that go far beyond what macOS's built-in clipboard does—which is save exactly one item at a time. The core function is simple: CopyQ watches your clipboard and saves every text snippet, image, URL, and file reference you copy. Instead of losing the previous clipboard item when you copy something new, CopyQ keeps a history of hundreds or thousands of items. Press a hotkey, search for what you copied two hours ago, and paste it. This alone saves time for anyone who regularly copies and pastes between apps. What separates CopyQ from simpler clipboard managers (like Maccy or Paste) is its power-user feature set. CopyQ supports tabs for organizing clipboard items by category—one tab for code snippets, another for URLs, another for project-specific content. You can tag items, edit them before pasting, and pin frequently used items to the top. The built-in editor supports text formatting, and images preview directly in the clipboard history. CopyQ's killer feature is its scripting engine. You can write commands in JavaScript or use the built-in scripting language to automate clipboard operations. Automatically strip formatting from copied text. Transform URLs (decode encoded characters, remove tracking parameters). Run a script that processes clipboard content before pasting it. Trigger actions when specific content patterns are copied. The scripting system is powerful enough that CopyQ doubles as a text automation tool. The interface isn't as polished as commercial alternatives like Paste ($3.99/month) or Alfred's clipboard history. CopyQ uses Qt for its UI, which doesn't look native on macOS. But if you value power and customization over visual polish, CopyQ gives you capabilities that the pretty alternatives can't match. And it's completely free.
Install with Homebrew
brew install --cask copyqDeep Dive: Clipboard Automation — Beyond Copy-Paste
How CopyQ's scripting engine transforms clipboard management into a text automation platform.
History & Background
Clipboard managers have existed since the early days of GUI computing. On macOS, the category was popularized by apps like Flycut, ClipMenu, and later Paste and Maccy. CopyQ originated in the Linux ecosystem where scriptable, configurable tools are preferred over polished GUIs. Its Qt-based architecture made it naturally cross-platform, and the macOS port brought Linux-style power to Mac users who wanted more than a simple history list.
How It Works
CopyQ monitors the system clipboard through platform-specific APIs (NSPasteboard on macOS). When a clipboard change is detected, CopyQ reads the content (including all pasteboard types—text, HTML, images, file URLs), stores it in a SQLite database, and optionally triggers automatic commands. The scripting engine runs JavaScript (via Qt's QJSEngine) with CopyQ-specific APIs for reading, modifying, and writing clipboard content. Commands can modify clipboard content in-place, create new items, move items between tabs, or trigger external processes.
Ecosystem & Integrations
The clipboard manager category on macOS includes free options (CopyQ, Maccy, Flycut), one-time purchases (Alfred's Clipboard with Powerpack at $34), and subscriptions (Paste at $3.99/month). CopyQ occupies the 'power user' niche—it has fewer users than Maccy or Paste but deeper functionality. The scripting community shares commands on GitHub that automate common tasks like URL cleaning, JSON formatting, and text transformation.
Future Development
CopyQ development is community-driven with the primary developer maintaining the core and contributors adding features. Recent work includes improved macOS integration (notification center, Shortcuts compatibility), better image handling, and more expressive scripting APIs. The roadmap is organic—features are driven by community need rather than a commercial product plan.
Key Features
Unlimited Clipboard History
CopyQ saves every item you copy—text, images, HTML, URLs, file paths, and arbitrary data formats. The history is persistent across reboots and can be configured to store thousands of items. Each item shows a preview, timestamp, and source application. Search by content, filter by type, and sort by date or frequency. The history is the foundation that everything else builds on.
Tabbed Organization
Organize clipboard items into tabs. Create tabs for different projects, content types, or workflows. A 'Code Snippets' tab holds frequently used code blocks. A 'URLs' tab collects links. A 'Meeting Notes' tab saves copied text from video calls. Items can be moved between tabs manually or automatically based on rules. Tabs persist across sessions, turning CopyQ into a lightweight note organizer.
Scripting & Commands
CopyQ includes a scripting engine that processes clipboard content automatically. Write commands in JavaScript or CopyQ's scripting syntax that trigger on clipboard changes. Examples: strip HTML formatting from all copied text, remove UTM tracking parameters from URLs, auto-capitalize text, add timestamps to copied items, or send clipboard content to an API. Commands can also be triggered manually from the CopyQ window or via global hotkeys.
Global Shortcuts
Configure global hotkeys for clipboard operations. The main shortcut opens the clipboard history window for browsing and searching. Additional shortcuts can paste specific items from history (paste item #2, paste item #3), toggle tabs, or trigger custom commands. On macOS, shortcuts work system-wide and can be set to any key combination.
Search & Filtering
Type in the CopyQ window to instantly filter clipboard history. Search matches content, tab names, and tags. Regular expressions are supported for pattern matching—search for email addresses, URLs, phone numbers, or any pattern across your entire clipboard history. For power users who copy hundreds of items daily, fast search is essential.
Content Encryption & Exclusion
CopyQ can encrypt stored clipboard items for sensitive data and exclude specific applications from clipboard monitoring. Don't want password manager copies saved in history? Exclude 1Password or Bitwarden. Need to keep sensitive snippets but protect them? Encrypt items with a passphrase. This addresses the primary security concern with clipboard managers—that they save everything, including passwords and secrets.
Who Should Use CopyQ?
1Software Developer
A developer copies code snippets, error messages, Stack Overflow URLs, and variable names constantly throughout the day. CopyQ saves everything and lets them search for that error message they copied three hours ago. A custom command strips trailing whitespace from copied code. Tabs organize snippets by project. The scripting engine auto-detects JSON strings in the clipboard and pretty-prints them.
2Writer / Researcher
A writer researches an article by copying quotes, facts, and URLs from dozens of sources. Each source goes into a project-specific CopyQ tab. When writing, they search the tab for relevant quotes and paste them with the source URL attached (via a custom command). The clipboard history becomes a research database that persists until the article is published.
3Support Engineer
A support engineer handles tickets all day, repeatedly pasting common responses, diagnostic commands, and KB article links. CopyQ's pinned items keep the top 20 most-used responses accessible via hotkey. Tags categorize responses by product area. When a new common response is needed, they add it to CopyQ once and access it instantly on every subsequent ticket.
How to Install CopyQ on Mac
CopyQ is available through Homebrew and provides a standard macOS application.
Install via Homebrew
Run `brew install --cask copyq`. This downloads and installs CopyQ to your Applications folder.
Grant Accessibility Permissions
On first launch, macOS will ask for accessibility permissions. Go to System Settings > Privacy & Security > Accessibility and toggle CopyQ on. This is required for global hotkeys and clipboard monitoring.
Set Global Shortcut
Open CopyQ Preferences > Shortcuts and set a global shortcut to open the clipboard history (recommended: Cmd+Shift+V or a similar unused combination). This shortcut works from any application.
Enable Launch at Login
CopyQ only monitors the clipboard while running. Enable auto-launch in Preferences or add CopyQ to your login items in System Settings.
Pro Tips
- • Set the history size in Preferences > History. The default is reasonable (200 items) but power users should increase it to 1000+.
- • Create your first tab immediately — a 'Snippets' tab for frequently pasted text separates permanent items from transient clipboard content.
- • The command-line tool `copyq` provides full access to CopyQ from terminal scripts and automation tools.
Configuration Tips
Create a 'Strip Formatting' Command
In CopyQ commands (F6), create an automatic command that triggers on clipboard change: if the clipboard contains HTML, convert it to plain text. This ensures everything you paste is plain text—no more fighting with formatting when pasting from web pages into documents.
Set Up App Exclusions
In Preferences, add your password manager (1Password, Bitwarden, KeePassXC) to the exclusion list. This prevents CopyQ from saving passwords to clipboard history—a basic but important security measure.
Alternatives to CopyQ
Clipboard managers for macOS range from minimal to full-featured, free to subscription.
Maccy
Maccy is a free, open-source clipboard manager that prioritizes simplicity. It shows clipboard history in a native macOS menu with fuzzy search. No tabs, no scripting, no content editing—just a fast, lightweight history. If you want 'copy history and nothing more,' Maccy is perfect. If you want organization and automation, CopyQ is the choice.
Paste
Paste is a commercial clipboard manager ($3.99/month) with a beautiful visual interface, iCloud sync across devices, and integration with Shortcuts. It's the most polished option for users who value design. The subscription cost and lack of scripting/automation make it a different tool than CopyQ—Paste is for aesthetics and simplicity, CopyQ is for power.
Alfred Clipboard History
Alfred (with Powerpack, $34 one-time) includes clipboard history as one of many features. It's integrated into Alfred's launcher, which is convenient if you already use Alfred. The clipboard history is capable but not as deep as CopyQ—no scripting, no tabs, no encryption. Alfred is the better choice if you want a unified launcher+clipboard tool.
Pricing
CopyQ is completely free under the GNU GPL v3 license. No premium tier, no subscription, no ads, no data collection. The source code is on GitHub and accepts contributions from the community.
Pros
- ✓Free and open-source with no premium tier or feature gating
- ✓Scripting engine enables clipboard automation beyond any competitor
- ✓Cross-platform (macOS, Linux, Windows) with synced workflows
- ✓Tabbed organization turns clipboard history into a structured system
- ✓Content encryption and app exclusion address security concerns
- ✓Command-line interface enables integration with shell scripts and automation
- ✓Regular expression search across entire clipboard history
Cons
- ✗Qt-based interface doesn't look native on macOS — visual mismatch with system UI
- ✗Initial setup and configuration require more effort than simpler alternatives
- ✗Scripting power comes with a learning curve
- ✗No cloud sync between devices
- ✗Image previews are functional but not as clean as commercial alternatives
- ✗Menu bar integration is basic compared to Maccy or Paste
Community & Support
CopyQ is maintained by Lukas Holecek on GitHub (hluk/CopyQ). The repository has 8,000+ stars and an active issue tracker where the developer responds to bug reports and feature requests. Documentation is available on the CopyQ GitHub wiki, covering installation, configuration, scripting, and command examples. Community-contributed scripts and commands are shared on GitHub discussions and the CopyQ wiki's 'Tips' page. Reddit's r/macapps community includes CopyQ users who share configurations and automation ideas.
Video Tutorials
Getting Started with CopyQ
More Tutorials
Install CopyQ (Clipboard Manager) on Omarchy Linux in Minutes!
Puru Tuladhar • 2.1K views
5 Ways to Use a Mac Clipboard App
Stephen Robles • 65.7K views
Apple just copied @mkbhd’s fav app Raycast on Mac’s Spotlight – WWDC 25🤯
Singular Podcast • 146.8K views
Frequently Asked Questions about CopyQ
Our Verdict
CopyQ is the most powerful clipboard manager available on macOS—the scripting engine, tabbed organization, and content processing capabilities are unmatched by any alternative, free or paid. The trade-off is a Qt interface that doesn't look native and a configuration process that requires more initial effort. For power users and developers who want to automate clipboard workflows, CopyQ is the clear choice. For users who want a simple, pretty clipboard history, Maccy or Paste are better fits. CopyQ earns 4.2 instead of 4.5 because the non-native interface and setup complexity create friction for casual users.
About the Author
Productivity & Workflow Analyst
Related Technologies & Concepts
Related Topics
Clipboard & Text Management
Tools for managing clipboard history and text snippets on macOS.
Sources & References
Fact-CheckedLast verified: Feb 23, 2026
- 1CopyQ — Clipboard Manager
Accessed Feb 23, 2026
Research queries: CopyQ clipboard manager Mac 2026