Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/p0deje/Maccy
Lightweight clipboard manager for macOS
https://github.com/p0deje/Maccy
clipboard-manager maccy macos
Last synced: about 1 month ago
JSON representation
Lightweight clipboard manager for macOS
- Host: GitHub
- URL: https://github.com/p0deje/Maccy
- Owner: p0deje
- License: mit
- Created: 2018-01-31T05:01:53.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T19:09:03.000Z (about 1 month ago)
- Last Synced: 2024-04-24T06:31:57.745Z (about 1 month ago)
- Topics: clipboard-manager, maccy, macos
- Language: Swift
- Homepage: https://maccy.app
- Size: 67.6 MB
- Stars: 10,438
- Watchers: 56
- Forks: 457
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-mac - Maccy - 开源于GitHub但不免费的剪贴板管理工具,应用商店中下载需要付费。 [![Open-Source Software][OSS Icon]](https://github.com/p0deje/Maccy) ![Freeware][Freeware Icon] (其它实用工具 / 剪贴板工具)
- open-source-mac-os-apps - Maccy - Lightweight search-as-you-type clipboard manager. ![swift_icon] (Applications / Productivity)
- awesome-stars - Maccy
- awesome-stars - Maccy
- macOS-Essentials - Maccy - clipboard manager (Applications / Productivity)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - Maccy
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (macos)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (macos)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- my-awesome-starred - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-macos - Maccy - Clean and simple clipboard manager [`brew install --cask maccy`] (Utilities)
- awesome-stars - Maccy
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- my-awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- my-awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- my-awesome - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - `★10814` Lightweight clipboard manager for macOS (Swift)
- gitcat - Maccy
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
- awesome-stars - p0deje/Maccy - Lightweight clipboard manager for macOS (Swift)
README
# [Maccy](https://maccy.app)
[![Downloads](https://img.shields.io/github/downloads/p0deje/Maccy/total.svg)](https://github.com/p0deje/Maccy/releases/latest)
[![Build Status](https://img.shields.io/bitrise/716921b669780314/master?token=3pMiCb5dpFzlO-7jTYtO3Q)](https://app.bitrise.io/app/716921b669780314)
[![Donate](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg)](https://www.buymeacoffee.com/p0deje)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 Mojave 10.14 or higher.
* [Features](#features)
* [Install](#install)
* [Usage](#usage)
* [Advanced](#advanced)
* [Ignore Copied Items](#ignore-copied-items)
* [Ignore Custom Copy Types](#ignore-custom-copy-types)
* [FAQ](#faq)
* [Why doesn't it paste when I select an item in history?](#why-doesnt-it-paste-when-i-select-an-item-in-history)
* [Motivation](#motivation)
* [License](#license)## Features
* Lightweight and fast
* Keyboard-first
* Secure and private
* Native UI
* Open source and free## Install
Download the latest version from the [releases](https://github.com/p0deje/Maccy/releases/latest) page, or use [Homebrew](https://brew.sh/):
```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.
### Ignore Custom Copy Types
By default Maccy 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 preferences or `defaults`:
```sh
defaults write org.p0deje.Maccy ignoredPasteboardTypes -array-add "com.myapp.CustomType"
```If you need to find what custom types are used by an application, you can use
free application [Pasteboard-Viewer](https://github.com/sindresorhus/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](https://github.com/p0deje/Maccy/issues/125).If you accidentally removed default types, you can restore the original configuration:
```sh
defaults write org.p0deje.Maccy ignoredPasteboardTypes -array "de.petermaurer.TransientPasteboardType" "com.typeit4me.clipping" "Pasteboard generator type" "com.agilebits.onepassword" "net.antelle.keeweb"
```
## 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.## Motivation
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](http://parcellite.sourceforge.net),
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](./LICENSE)