Lodge

Lodge is a lightweight clipboard manager for macOS and a hard fork of Maccy by p0deje. All credit for the original app belongs to the Maccy contributors.

Lodge works on macOS Sonoma 14 or higher.

Text preview with detail panel	Image preview	OCR text search in images
Split view with content preview, source app, word count, and timestamps.	Full image preview with metadata.	Search finds text inside images using built-in OCR.

• Fork Notice
• Differences from Maccy
• 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 Lodge, 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

Fork Notice

Lodge is a hard fork of Maccy. This repository exists to explore independent changes while crediting the original project. For the official releases and upstream updates, use Maccy.

Differences from Maccy

• Rebranded as Lodge (name and documentation).
• New popup style: split view with a detail panel showing previews and metadata (source app, content type, counts, timestamps).
• Optional application icons in the history list.
• History list no longer shows the shortcut badges column.
• Performance work: cached previews, precomputed text stats, and search caching for large histories.
• New bundle identifier (com.nklmilojevic.Lodge) and Lodge Xcode scheme.

Features

• Lightweight and fast (inherited from Maccy)
• Keyboard-first workflows
• Split view with an adjustable divider, or an optional compact view
• Full text search and a separate action to view long text
• OCR text search in images
• Pinned items with quick actions
• Optional source-application icons
• Secure and private
• Native UI
• Open source and free

Install

Homebrew

brew install nklmilojevic/lodge/lodge

Download

Download the latest release from the GitHub releases page.

Build from source

xcodebuild -scheme Lodge -configuration Debug

Distribution

For GitHub releases, notarization, and Sparkle appcast setup, see docs/distribution.md.

Usage

Usage is currently the same as Maccy, with the addition of the split view detail panel. Keyboard shortcuts are unchanged.

1. SHIFT (⇧) + COMMAND (⌘) + C to popup Lodge 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 read an item, use the detail panel in split view. For text longer than 5,000 characters, select View full text. Search includes the full text.
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 Lodge 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 the Preferences window, or press COMMAND (⌘) + ,.

In Appearance settings, enable Compact view to show only the history list. In split view, drag the divider to change the list width.

Storage settings include a history data limit of 512 MB by default. This limit includes copied data, search text, and previews. Lodge removes the oldest unpinned items to stay within the limit. Pinned items are kept. A notice appears if pinned items exceed the limit. Database files can use additional disk space.

For development, tests, and performance checks, see docs/architecture.md.

Advanced

Ignore Copied Items

You can tell Lodge to ignore all copied items:

defaults write com.nklmilojevic.Lodge 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 Lodge will ignore certain copy types that are considered to be confidential or temporary. The default list always include 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. Simply download the application, open it, copy something from the application you want to ignore and look for any custom types in the left sidebar. Here is an example of using this approach to ignore Adobe InDesign.

Speed up Clipboard Check Interval

By default, Lodge checks clipboard every 500 ms, which should be enough for most users. If you want to speed it up, you can change it with defaults:

defaults write com.nklmilojevic.Lodge 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 Lodge is added to System Settings -> Privacy & Security -> Accessibility.

When assigning a hotkey to open Lodge, 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 (screenshot).
4. Restart Lodge.
5. Assign hotkey in Lodge settings.

How to restore hidden footer?

1. Open Lodge 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.nklmilojevic.Lodge 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. See detailed solution.

Translations

Translations are maintained in the upstream Maccy project on Weblate. This fork currently inherits those translations; please contribute there so the original project is credited.

Motivation

This section is preserved from the upstream Maccy README for attribution:

There are dozens of similar applications out there, so why build another? Over the past years since I moved from Linux to macOS, I struggled to find a clipboard manager that is as free and simple as Parcellite, but I couldn't. So I've decided to build one.

Also, I wanted to learn Swift and get acquainted with macOS application development.

License

MIT