ClipMasterCM 1.1.1
July 10, 2006


Abracode
http://www.abracode.com/
Support: e-mail Abracode

What is it?
ClipMasterCM is a contextual menu plug-in for easy access to frequently used bits of information.

Requirements

Mac OS 10.3.9 or higher. The plug-in works in both Carbon and Cocoa applications. It works on Intel Macs.

Introduction
ClipMasterCM is a solution to a problem of accessing and organizing various bits of frequently used information as text, pictures, movies, sounds, etc. It allows you to save current clipboard content for later pasting. You may collect and organize information snippets and have them available with just one click (control-click or right-click to be precise). Since it is a contextual menu plugin you not need to run a separate application - it does not take any space on your desktop, menu bar or dock.

Installation
Please double click "ClipMasterCM Installer.pkg" and follow the instructions. After successful installation you need to quit all running applications and start them again to use contextual menu plug-in.

Package components
The package consists of contextual menu plug-in "ClipMasterCM.plugin" which is installed in:
/Library/Contextual Menu Items/
The list of your clips is saved in the preference file:
/Users/you/Library/Preferences/com.abracode.ClipMasterCM.plist
The preference file does not contain the data of saved clips, the actual clips are stored in:
/Users/you/Library/Application Support/Clip Master/
Encrypted clips are stored in:
/Users/you/Library/Application Support/Clip Master/ClipMaster.keychain

Contextual Menu Usage
ClipMasterCM should work in any application supporting contextual menus. If it doesn't work in your front application, just control-click on the desktop in Finder and the contextual menu will be invoked. The usage of this contextual menu is pretty straightforward. When you have something in clipboard which you would like to keep for later use, just control-click (or right click if you use 2 button mouse) and the contextual menu should appear with "Clip Master" submenu. Then choose "Add Clipboard Content..." and a dialog should appear asking for a clip name and submenu name. If the clipboard contains text a default name for this clip will be suggested based on first words. Entering submenu name other than "Clip Master" will assign the new clip item to new submenu. This way you may group clips thematically. When you press "Create" button, the new clip will be saved to hard drive and item referring to it will be added to contextual menu. Next time you control-/right-click the new clip will be listed in proper submenu. Choosing the clip item from the contextual submenu will trigger paste operation. If the current context enables pasting (for example text editor when you have text in clipboard) selecting clip item will work as a regular paste: the clip will be put to clipboard and paste will be invoked. If you choose a clip item in context where paste is not available (for example clicking on a desktop in Finder) the paste operation will silently fail but the clip will still be placed in the clipboard.
You need to keep in mind that ClipMasterCM works through clipboard therefore choosing clip item from menu is like copy-paste operation and side effect is that it replaces the current content of your clipboard.
As a convenience an additional method of creating a new clip was added: using currently selected text. When you control-click on selected text in some text editing application (TextEdit for example) a new option is displayed: "Add Selected Text...". The dialog invoked is the same: you enter a clip name and submenu name. However, there is one very important difference between adding text from selection and adding text from clipboard. In most applications text copied to clipboard contains style information and everything is saved to the new clip. When you use text from selection, no style is added - only raw text in classic 1 byte encoding and 2 byte Unicode representation is saved ('TEXT' and 'utxt' flavors). This may cause a problem with international text (especially 2-byte encodings like Japanese) as the lack of style information may confuse some text editors unable to deal with Unicode text flavor present in clipboard. A workaround in such case is not to use the "Add Selected Text..." option but copy the selected fragment to clipboard and use "Add Clipboard Content..." command.
You may remove a clip from your list by pressing the "option" key when choosing an item. When you press "option" key item names will change and will be preceded with a hyphen indicating that choosing an item will remove it from the list.
Editing once created clip is currently very limited. You may do it by manually opening the preferences file: com.abracode.ClipMasterCM.plist and changing the "NAME" or "SUBMENU" key. Be careful not to change the "FILENAME" key because it will break the link between the menu item and the actual clip saved in /Users/you/Library/Application Support/Clip Master/ folder. A user-friendly editing may be provided in future versions of ClipMasterCM.


Keychain support
Starting with version 1.1 ClipMasterCM allows you to store you clippings in keychain. The information stored in keychain is encrypted and secure. Before using this feature you need to create a new keychain and assign a master password to it. Use the "Create New Keychain..." option under "Clip Master" submenu. You will be asked for a password and the new keychain will be created in:
/Users/you/Library/Application Support/Clip Master/ClipMaster.keychain
Next time you add a clipping, click on "Secure Note (store in keychain)" in the "Create New Clip" dialog.
In order to access the clipping stored in keychain you need to unlock the keychain. Use "Unlock Keychain..." in "Clip Master" submenu. Keychain stays unlocked for about 5 minutes and then locks itself back. You can also lock it manually as soon as you are done. Secure notes stored in keychain do not show in Clip Master contextual menu when the keychain is locked. Please note that the menu item name itself is not encrypted, even if it does not show when the keychain is locked. Do not put any secret information in the name itself. For credit card number use some descriptive name like "Citibank CC #" but not the number itself or the expiration date.
If you want to change the encrypted data you can double-click on ClipMaster.keychain and open it with "Keychain Access" but please note that adding or deleting items in this keychain will not be reflected in contextual menu itself. You need to use Clip Master to add or remove items.


Multilevel submenus
ClipMasterCM 1.1 and higher supports multilevel submenus for better organization of your clippings. Submenus are specified as a pseudo-path, for example: "/My Clippings/Work Related/Passwords".


Version History

1.1.1 July 10, 2006
Universal Binary

1.1r2 December 26, 2005
Added localizations:
Japanese localization update thanks to Yuzuru Shiraiwa
German localization update thanks to Knut Lorenzen
Traditional Chinese - new localization from Jack Lin

1.1 December 20, 2005
Added clipping encryption support
Added multi level submenu support
Shareware changed to freeware

1.0.1 October 22, 2003
Added Japanese and German localizations thanks to Hideki Itoh and Knut Lorenzen

1.0r2 September 23, 2003
Fixed a serial number problem

1.0 September 22, 2003
Initial release