{"id":15039365,"url":"https://github.com/p0deje/maccy","last_synced_at":"2025-05-11T03:51:23.744Z","repository":{"id":37251620,"uuid":"119637215","full_name":"p0deje/Maccy","owner":"p0deje","description":"Lightweight clipboard manager for macOS","archived":false,"fork":false,"pushed_at":"2025-04-18T04:40:35.000Z","size":83187,"stargazers_count":15148,"open_issues_count":67,"forks_count":647,"subscribers_count":72,"default_branch":"master","last_synced_at":"2025-05-11T03:51:16.024Z","etag":null,"topics":["clipboard-manager","maccy","macos"],"latest_commit_sha":null,"homepage":"https://maccy.app","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/p0deje.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"p0deje"}},"created_at":"2018-01-31T05:01:53.000Z","updated_at":"2025-05-11T03:37:04.000Z","dependencies_parsed_at":"2023-10-11T01:36:08.600Z","dependency_job_id":"18733637-b07a-48b6-b56c-7782e231701a","html_url":"https://github.com/p0deje/Maccy","commit_stats":null,"previous_names":[],"tags_count":84,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p0deje%2FMaccy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p0deje%2FMaccy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p0deje%2FMaccy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p0deje%2FMaccy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/p0deje","download_url":"https://codeload.github.com/p0deje/Maccy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253514570,"owners_count":21920335,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clipboard-manager","maccy","macos"],"created_at":"2024-09-24T20:42:35.103Z","updated_at":"2025-05-11T03:51:23.726Z","avatar_url":"https://github.com/p0deje.png","language":"Swift","readme":"\n\u003cimg width=\"128px\" src=\"https://maccy.app/img/maccy/Logo.png\" alt=\"Logo\" align=\"left\" /\u003e\n\n# [Maccy](https://maccy.app)\n\n[![Downloads](https://img.shields.io/github/downloads/p0deje/Maccy/total.svg)](https://github.com/p0deje/Maccy/releases/latest)\n[![Build Status](https://img.shields.io/bitrise/716921b669780314/master?token=3pMiCb5dpFzlO-7jTYtO3Q)](https://app.bitrise.io/app/716921b669780314)\n\nMaccy is a lightweight clipboard manager for macOS. It keeps the history of what you copy\nand lets you quickly navigate, search, and use previous clipboard contents.\n\nMaccy works on macOS Sonoma 14 or higher.\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [Features](#features)\n* [Install](#install)\n* [Usage](#usage)\n* [Advanced](#advanced)\n  * [Ignore Copied Items](#ignore-copied-items)\n  * [Ignore Custom Copy Types](#ignore-custom-copy-types)\n  * [Speed up Clipboard Check Interval](#speed-up-clipboard-check-interval)\n* [FAQ](#faq)\n  * [Why doesn't it paste when I select an item in history?](#why-doesnt-it-paste-when-i-select-an-item-in-history)\n  * [When assigning a hotkey to open Maccy, it says that this hotkey is already used in some system setting.](#when-assigning-a-hotkey-to-open-maccy-it-says-that-this-hotkey-is-already-used-in-some-system-setting)\n  * [How to restore hidden footer?](#how-to-restore-hidden-footer)\n  * [How to ignore copies from Universal Clipboard?](#how-to-ignore-copies-from-universal-clipboard)\n* [Translations](#translations)\n* [Motivation](#motivation)\n* [License](#license)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n## Features\n\n* Lightweight and fast\n* Keyboard-first\n* Secure and private\n* Native UI\n* Open source and free\n\n## Install\n\nDownload the latest version from the [releases](https://github.com/p0deje/Maccy/releases/latest) page, or use [Homebrew](https://brew.sh/):\n\n```sh\nbrew install maccy\n```\n\n## Usage\n\n1. \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e + \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + \u003ckbd\u003eC\u003c/kbd\u003e to popup Maccy or click on its icon in the menu bar.\n2. Type what you want to find.\n3. To select the history item you wish to copy, press \u003ckbd\u003eENTER\u003c/kbd\u003e, or click the item, or use \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + `n` shortcut.\n4. To choose the history item and paste, press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eENTER\u003c/kbd\u003e, or \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eCLICK\u003c/kbd\u003e the item, or use \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + `n` shortcut.\n5. To choose the history item and paste without formatting, press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e + \u003ckbd\u003eENTER\u003c/kbd\u003e, or \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e + \u003ckbd\u003eCLICK\u003c/kbd\u003e the item, or use \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e + `n` shortcut.\n6. To delete the history item, press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eDELETE (⌫)\u003c/kbd\u003e.\n7. To see the full text of the history item, wait a couple of seconds for tooltip.\n8. To pin the history item so that it remains on top of the list, press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e. The item will be moved to the top with a random but permanent keyboard shortcut. To unpin it, press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e again.\n9. To clear all unpinned items, select _Clear_ in the menu, or press \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + \u003ckbd\u003eDELETE (⌫)\u003c/kbd\u003e. To clear all items including pinned, select _Clear_ in the menu with  \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e pressed, or press \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e + \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + \u003ckbd\u003eDELETE (⌫)\u003c/kbd\u003e.\n10. To disable Maccy and ignore new copies, click on the menu icon with \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e pressed.\n11. To ignore only the next copy, click on the menu icon with \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e pressed.\n12. To customize the behavior, check \"Preferences…\" window, or press \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + \u003ckbd\u003e,\u003c/kbd\u003e.\n\n## Advanced\n\n### Ignore Copied Items\n\nYou can tell Maccy to ignore all copied items:\n\n```sh\ndefaults write org.p0deje.Maccy ignoreEvents true # default is false\n```\n\nThis 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.\n\nYou can also click the menu icon with \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e pressed. To ignore only the next copy, click with \u003ckbd\u003eOPTION (⌥)\u003c/kbd\u003e + \u003ckbd\u003eSHIFT (⇧)\u003c/kbd\u003e pressed.\n\n### Ignore Custom Copy Types\n\nBy default Maccy will ignore certain copy types that are considered to be confidential\nor temporary. The default list always include the following types:\n\n* `org.nspasteboard.TransientType`\n* `org.nspasteboard.ConcealedType`\n* `org.nspasteboard.AutoGeneratedType`\n\nAlso, default configuration includes the following types but they can be removed\nor overwritten:\n\n* `com.agilebits.onepassword`\n* `com.typeit4me.clipping`\n* `de.petermaurer.TransientPasteboardType`\n* `Pasteboard generator type`\n* `net.antelle.keeweb`\n\nYou can add additional custom types using settings.\nTo find what custom types are used by an application, you can use\nfree application [Pasteboard-Viewer](https://github.com/sindresorhus/Pasteboard-Viewer).\nSimply download the application, open it, copy something from the application you\nwant to ignore and look for any custom types in the left sidebar. [Here is an example\nof using this approach to ignore Adobe InDesign](https://github.com/p0deje/Maccy/issues/125).\n\n### Speed up Clipboard Check Interval\n\nBy default, Maccy checks clipboard every 500 ms, which should be enough for most users. If you want\nto speed it up, you can change it with `defaults`:\n\n```sh\ndefaults write org.p0deje.Maccy clipboardCheckInterval 0.1 # 100 ms\n```\n\n## FAQ\n\n### Why doesn't it paste when I select an item in history?\n\n1. Make sure you have \"Paste automatically\" enabled in Preferences.\n2. Make sure \"Maccy\" is added to System Settings -\u003e Privacy \u0026 Security -\u003e Accessibility.\n\n### When assigning a hotkey to open Maccy, it says that this hotkey is already used in some system setting.\n\n1. Open System settings -\u003e Keyboard -\u003e Keyboard Shortcuts.\n2. Find where that hotkey is used. For example, \"Convert text to simplified Chinese\" is under Services -\u003e Text.\n3. Disable that hotkey or remove assigned combination ([screenshot](https://github.com/p0deje/Maccy/assets/576152/446719e6-c3e5-4eb0-95fb-5a811066487f)).\n4. Restart Maccy.\n5. Assign hotkey in Maccy settings.\n\n### How to restore hidden footer?\n\n1. Open Maccy window.\n2. Press \u003ckbd\u003eCOMMAND (⌘)\u003c/kbd\u003e + \u003ckbd\u003e,\u003c/kbd\u003e to open preferences.\n3. Enable footer in Appearance section.\n\nIf for some reason it doesn't work, run the following command in Terminal.app:\n\n```sh\ndefaults write org.p0deje.Maccy showFooter 1\n```\n\n### How to ignore copies from [Universal Clipboard](https://support.apple.com/en-us/102430)?\n\n1. Open Preferences -\u003e Ignore -\u003e Pasteboard Types.\n2. Add `com.apple.is-remote-clipboard`.\n\n## Translations\n\nThe translations are hosted in [Weblate](https://hosted.weblate.org/engage/maccy/).\nYou can use it to suggest changes in translations and localize the application to a new language.\n\n[![Translation status](https://hosted.weblate.org/widget/maccy/multi-auto.svg)](https://hosted.weblate.org/engage/maccy/)\n\n## Motivation\n\nThere are dozens of similar applications out there, so why build another?\nOver the past years since I moved from Linux to macOS, I struggled to find\na clipboard manager that is as free and simple as [Parcellite](http://parcellite.sourceforge.net),\nbut I couldn't. So I've decided to build one.\n\nAlso, I wanted to learn Swift and get acquainted with macOS application development.\n\n\n## License\n\n[MIT](./LICENSE)\n","funding_links":["https://buymeacoffee.com/p0deje"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp0deje%2Fmaccy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fp0deje%2Fmaccy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp0deje%2Fmaccy/lists"}