Documentation

Quick Start

FZClip runs in your menu bar and can be accessed anytime:

1. Click the FZClip icon in the menu bar, or press ⌘ ⌥ V
2. Start typing to search your clipboard history
3. Press Return to select and auto-paste the item

FZClip monitors your clipboard automatically. Just copy anything and it's saved instantly.

Views

FZClip organizes your content into five specialized views. Switch between them using ⌘ ] and ⌘ [ or click the tabs.

Clipboard

Your real-time clipboard history with powerful fuzzy search. Everything you copy is saved here automatically.

Favorites

Bookmark frequently used items for quick access. Press ⌘ F to toggle an item as favorite.

Images

Visual content with optional OCR text extraction. When OCR is enabled, you can search images by their text content.

Notes

Create and store custom text notes. Perfect for code snippets, templates, or any text you use frequently. Press ⌘ N to create a new note.

Terminal

Shell command history captured from Terminal or iTerm. This view requires accessibility permissions to be enabled in System Settings.

Key Features

Fuzzy Search

Find items with partial matches and substrings. Type "cmd" to find "command" or "git push" to find any item containing both words. The search is fast and flexible.

FZClip also supports fzf-style syntax for advanced queries:

• 'exact — Exact match (items must contain "exact")
• ^prefix — Starts with "prefix"
• suffix$ — Ends with "suffix"
• !exclude — Exclude items containing "exclude"
• ^start !skip end$ — Combine multiple patterns

Auto-Paste

When enabled in settings, selecting an item automatically pastes it into the active application. No extra steps needed.

Sensitive Content Blur

FZClip can automatically blur content copied from password managers like 1Password, Bitwarden, and others. Configure which apps trigger this behavior in Privacy settings.

Image OCR

Extracts text from copied images using macOS Vision framework. This enables searching through screenshots and images by their text content.

Data Persistence

Your clipboard history survives app restarts and system reboots. You can also export/import your data for backups or migration.

Settings

Open settings with ⌘ , or from the menu bar icon.

General

• Auto-paste on select — Automatically paste when selecting an item
• Preserve last view — Remember which view was active between sessions
• Follow active screen — Open window on the screen with mouse cursor
• Launch at login — Start FZClip automatically when you log in

Appearance

• Theme — Choose between Light, Dark, or System theme
• Window opacity — Adjust the background transparency
• Tint color — Customize the window background tint
• Highlight color — Choose selection highlight color

Views

• Enable/disable views — Show or hide specific views in the tab bar
• Enable OCR — Toggle text extraction from images
• Default view — Set which view opens by default

Privacy

• Blur sensitive apps — Configure which apps trigger content blur
• Accessibility permission — Required for Terminal view functionality

Storage

• History limit — Maximum number of items to keep in history
• Export data — Save your clipboard history to a file
• Import data — Restore from a previous export
• Automatic backups — Configure automatic backup settings

Keyboard Shortcuts

All shortcuts can be customized in Settings → Keyboard.