ClipCube Manual

Keyboard shortcuts

Global

Ctrl + Shift + CShow/hide the main window
Ctrl + Shift + XShow/hide the Direct Paste window

Main window

Ctrl + NAdd a new note
Ctrl + KRemove selected note(s)
Ctrl + SpaceToggle the editor
Ctrl + EnterCopy current note to the clipboard
Ctrl + FJump to search box
Ctrl + Up arrowSelect previous note
Ctrl + Down arrowSelect next note
Alt + NAdd new tag
Alt + KRemove selected tag
Alt + POpen properties for selected tag
Alt + Up arrowSelect previous tag
Alt + Down arrowSelect next tag
Ctrl + EOpen export dialog
Alt + EOpen export dialog with current tag selected
Ctrl + QQuit the program

Installation and upgrading

ClipCube is a portable program, which means that it is self-contained, and won't touch any files on your computer. Therefore, there is no need for installation. To start using it, unzip the executable to the folder of your choice. ClipCube will keep all its data and settings in that same folder.

Upgrading is done simply by overwriting the executable with the new one. Existing notes and settings are migrated automatically.

Basic operation

When started, ClipCube places itself as an icon in the system tray. When you start ClipCube the first time, its main window will show up as well. Closing this window will hide it, and the program will carry on running.

Clicking on the tray icon will toggle the main window. Right clicking on it will bring up the tray menu with a selection of commands. You can quit the program here as well. This is the default mode of operation, called System tray mode. There is also a mode that is more akin to running a normal desktop program (see the Preferences section).

The main window

There are two main sections: on the left side is the tag list, and on the right side the list of notes, newest note first. The note list will, of course, display the notes under the currently selected tag. In the tag list there are three built-in tags, the first of which is the Clipboard. This is a cornerstone of the program, here is where all copied items will appear. Searching can be done with the search box located in the top left corner.

Editing notes

All notes are editable, including the ones catched from the clipboard. The note editor can be toggled from the toolbar (the keyboard icon), or by pressing Ctrl+Space. There is no need to save the edits, it is automatic. The editor currently supports plain text. In the editor you can modify the font size, and toggle the monospace font (useful for example programmers and sysadmins). These settings are persistent.

Adding notes

There are three ways to add a new note: click icon on toolbar, press Ctrl+N, or select New Note from the system tray menu as a quick option.

Unless a user tag is selected, the new note will be created under Scratchpad. The system tray option will always create it there.

If a user tag is selected, the new note will be created under it.

Searching

Start typing into the search box and the results will start to appear, grouped by tag. The first match will be selected. Pressing Escape in the search box or clicking on the X will clear the search.

The tray menu

There are two commands here that are related to clipboard monitoring.

“Monitor the clipboard”: enables turning the monitoring on and off, of course. This is in effect while the program is running. The setting “Monitor the clipboard by default” (accessible in the Preferences window) will decide whether to turn on monitoring at program start.

“Trim incoming text”: when enabled, ClipCube will actively shave off whitespace (spaces, tabs, etc.) from the beginning and end of all copied text, right on the clipboard. The trimmed text gets stored. Again, this setting is in effect while the program is running. On program start it is disabled by default. (Note that in 1.1 it is incorrectly called "incoming text", because it actually works on the clipboard. The wording has been corrected since.)

Tagging

Most probably you are already familiar with the concept of tagging so it won't be explained here. ClipCube implements it with the addition of special, built-in tags: Clipboard, Links and Scratchpad, which will be explained below.

To tag one or more notes, select them, and open the Tag menu in the toolbar. Here you can select existing tags, and add new tags as well. When adding a new tag, a window appears, where you write the tag name, press Add; now this new tag is added to the Tag menu, selected.

When you are done with managing the tag selection, press the tick button which will apply the tagging. To cancel, just press the X or the toolbar button to close the Tag menu.

Clipboard

The text you copy in other programs (and ClipCube itself as well) will appear here. In the preferences, you can control how many clipboard items will be kept. When this number is reached, the oldest item will fall off the bottom when a new clip arrives.

The Clipboard tag can be thought of as a waterfall: items come and go. If you would like to save an item or more for later, select them, open the Tag menu on the toolbar, and either:

  • a) select 'Move to Scratchpad' as a quick option: just shove the items in the 'safe' location
  • b) tag items the normal way, explained above

The tagged items (or the ones moved to Scratchpad) will disappear from under Clipboard: you 'grabbed the fish from the waterfall'.

Links

Everything that looks like a web address is automatically copied here from under the Clipboard. Double-clicking a note here will open it in the web browser, instead of copying it to the clipboard (the default).

Scratchpad

This is the 'home' location for notes. The notes here are not tagged. Scratchpad is the default location for creating new notes.

Saving items from the Clipboard can be done quickly, by moving the selected notes here.

When all tags are removed from a note, it will end up in Scratchpad.

Preferences

All program preferences are stored next to the executable, in a file called ClipCube.ini. Delete this file if you would like to restore the default settings.

System tray mode

This setting is on by default. When unchecked, it puts ClipCube in a mode without the system tray icon, and from that point on the main window will behave like a regular one: the close button will quit the program.

Editing global hotkeys

In ClipCube.ini, you will find the lines starting with "GlobalHotkey...". The hotkey format consists of giving one or more modifier keys followed by a capital letter. These are joined with a +. Modifiers accepted:

  • ctrl
  • shift
  • alt
  • win

For example: win+shift+K

The range of allowed combinations will be expanded in subsequent releases. Also, it will be possible to set hotkeys in the Preferences window.