README

[!WARNING]
 Beware of fake websites impersonating Maccy. Malicious sites (such as maccyapp.net and maccyapp.com) distribute malware disguised as Maccy. maccy.app is the only official website.



 Maccy




Maccy is a lightweight clipboard manager for macOS. It keeps the history of what you copy
and lets you quickly navigate, search, and use previous clipboard contents.

Maccy works on macOS Sonoma 14 or higher.



 Features
 Install
 Usage
 Advanced
   Ignore Copied Items
   Ignore Custom Copy Types
   Speed up Clipboard Check Interval
 FAQ
   Why doesn't it paste when I select an item in history?
   When assigning a hotkey to open Maccy, it says that this hotkey is already used in some system setting.
   How to restore hidden footer?
   How to ignore copies from Universal Clipboard?
   My keyboard shortcut stopped working in password fields. How do I fix this?
 Translations
 Motivation
 License



 Features

 Lightweight and fast
 Keyboard-first
 Secure and private
 Native UI
 Open source and free

 Install

Download the latest version from the releases page, or use Homebrew:

sh
brew install maccy


 Usage

1. SHIFT (⇧) + COMMAND (⌘) + C to popup Maccy or click on its icon in the menu bar.
2. Type what you want to find.
3. To select the history item you wish to copy, press ENTER, or click the item, or use COMMAND (⌘) + n shortcut.
4. To choose the history item and paste, press OPTION (⌥) + ENTER, or OPTION (⌥) + CLICK the item, or use OPTION (⌥) + n shortcut.
5. To choose the history item and paste without formatting, press OPTION (⌥) + SHIFT (⇧) + ENTER, or OPTION (⌥) + SHIFT (⇧) + CLICK the item, or use OPTION (⌥) + SHIFT (⇧) + n shortcut.
6. To delete the history item, press OPTION (⌥) + DELETE (⌫).
7. To see the full text of the history item, wait a couple of seconds for tooltip.
8. To pin the history item so that it remains on top of the list, press OPTION (⌥) + P. The item will be moved to the top with a random but permanent keyboard shortcut. To unpin it, press OPTION (⌥) + P again.
9. To clear all unpinned items, select _Clear_ in the menu, or press OPTION (⌥) + COMMAND (⌘) + DELETE (⌫). To clear all items including pinned, select _Clear_ in the menu with  OPTION (⌥) pressed, or press SHIFT (⇧) + OPTION (⌥) + COMMAND (⌘) + DELETE (⌫).
10. To disable Maccy and ignore new copies, click on the menu icon with OPTION (⌥) pressed.
11. To ignore only the next copy, click on the menu icon with OPTION (⌥) + SHIFT (⇧) pressed.
12. To customize the behavior, check "Preferences…" window, or press COMMAND (⌘) + ,.

 Advanced

 Ignore Copied Items

You can tell Maccy to ignore all copied items:

sh
defaults write org.p0deje.Maccy ignoreEvents true  default is false


This is useful if you have some workflow for copying sensitive data. You can set ignoreEvents to true, copy the data and set ignoreEvents back to false.

You can also click the menu icon with OPTION (⌥) pressed. To ignore only the next copy, click with OPTION (⌥) + SHIFT (⇧) pressed.

 I

Top issues

Discussions

Latest release

- Added VoiceOver accessibility (1448).
- Added drag and drop reordering of pinned items.
- Added editing of pinned items inside the preview. The Pins settings pane is removed.
- Added support for special symbols as pin keys ([];'./-=\).
- Added image size to the image preview (1589).
- Added support for ignoring apps outside /Applications (1540).
- Improved OCR accuracy with automatic language detection (1586).
- Removed Safari WebArchives and other unselected pasteboard types storage (1543).
- Fixed memory leak of every history item (1552).
- Fixed slow menu bar title rendering with