Skip to content

iiHawe/MaccyPlus

 
 

Repository files navigation

Logo

Maccy+

Downloads

Maccy+ is a fork of Maccy — 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+ adds power-user enhancements on top of the original:

  • Multi-select enabled by default — select multiple history items at once using SHIFT (⇧) + / or COMMAND (⌘) + click
  • Unlimited history — set history size to 0 in Preferences to keep an unlimited number of entries

Maccy+ works on macOS Sonoma 14 or higher.

Features

  • Lightweight and fast
  • Keyboard-first
  • Secure and private
  • Native UI
  • Multi-select support (enabled by default)
  • Unlimited clipboard history

Install

Download the latest version from the releases page.

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 (⌘) + ,.

Maccy+ Enhancements

Multi-Select

Multi-select is enabled by default in Maccy+. You can select multiple clipboard history items and paste them all at once:

  • Range select: Hold SHIFT (⇧) and press / to extend the selection
  • Individual select: Hold COMMAND (⌘) and click items to toggle them in/out of the selection
  • Press ENTER or OPTION (⌥) + ENTER to copy/paste all selected items

Unlimited History

By default Maccy+ keeps a limited number of history entries. To store an unlimited number of items:

  1. Open Preferences (COMMAND (⌘) + ,).
  2. Go to the General tab.
  3. Set the Size field to 0.

With size set to 0, Maccy+ will never automatically remove old entries.

Advanced

Ignore Copied Items

You can tell Maccy+ to ignore all copied items:

defaults write com.hawe.MaccyPlus 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.

Ignore Custom Copy Types

By default Maccy+ will ignore certain copy types that are considered to be confidential or temporary. The default list always includes the following types:

  • org.nspasteboard.TransientType
  • org.nspasteboard.ConcealedType
  • org.nspasteboard.AutoGeneratedType

Also, default configuration includes the following types but they can be removed or overwritten:

  • com.agilebits.onepassword
  • com.typeit4me.clipping
  • de.petermaurer.TransientPasteboardType
  • Pasteboard generator type
  • net.antelle.keeweb

You can add additional custom types using settings. To find what custom types are used by an application, you can use free application Pasteboard-Viewer.

Speed up Clipboard Check Interval

By default, Maccy+ checks clipboard every 500 ms. To change it:

defaults write com.hawe.MaccyPlus clipboardCheckInterval 0.1 # 100 ms

FAQ

Why doesn't it paste when I select an item in history?

  1. Make sure you have "Paste automatically" enabled in Preferences.
  2. Make sure "Maccy+" is added to System Settings -> Privacy & Security -> Accessibility.

When assigning a hotkey to open Maccy+, it says that this hotkey is already used in some system setting.

  1. Open System settings -> Keyboard -> Keyboard Shortcuts.
  2. Find where that hotkey is used. For example, "Convert text to simplified Chinese" is under Services -> Text.
  3. Disable that hotkey or remove assigned combination.
  4. Restart Maccy+.
  5. Assign hotkey in Maccy+ settings.

How to restore hidden footer?

  1. Open Maccy+ window.
  2. Press COMMAND (⌘) + , to open preferences.
  3. Enable footer in Appearance section.

If for some reason it doesn't work, run the following command in Terminal.app:

defaults write com.hawe.MaccyPlus showFooter 1

How to ignore copies from Universal Clipboard?

  1. Open Preferences -> Ignore -> Pasteboard Types.
  2. Add com.apple.is-remote-clipboard.

My keyboard shortcut stopped working in password fields. How do I fix this?

If your shortcut produces a character (like Option+C → "ç"), macOS security may block it in password fields. Use Karabiner-Elements to remap your shortcut to a different combination like Cmd+Shift+C.

Translations

Maccy+ inherits translations from the upstream Maccy project, hosted on Weblate.

License

MIT

About

Lightweight clipboard manager for macOS

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Swift 100.0%