Home Using The File Shelf

Using The File Shelf

Once you have started a comparison the File Shelf, located at the top of Kaleidoscope's main window, shows you the files that have been imported.

Opening and Closing

You can open and close the File Shelf using one of the following methods:

In Preferences > General you find an option to control the default behavior of the File Shelf.

A and B

Two of the items in the File Shelf are always marked as A and B. These are the two items that are used in the comparison at any given time. By default, in Kaleidoscope, file A is considered the older of the two and file B the newer version.

You can change which files are selected as A and B using one of the following methods:

File Shelf Item Actions

Click the small chevron down button in a file shelf item to choose from the following options. You can also control or right-click the whole item for the same options:

Open With…
Allows you to open the file in an external application of your choice.
Reveal in Finder
Will open the Finder with the file selected.
Copy Path
Will copy the entire file path onto the pasteboard.
Select as A, Select as B
Select that item to be shown as A or B.
Set Display Name
Lets you enter a custom name for that item. This can be helpful with identifying items with undistinguishable or generic names.
Remove
Removes the item from the File Shelf.

Reordering, Removing and Adding Items

You can reorder the files by dragging them around.

You can remove items from the File Shelf by using one of the following methods:

You can add a new file to the comparison by using one of the following methods:

Naming Items

In some situations, particularly with lots of items that don't have useful names, such as items from the clipboard or other integrations, it can be helpful to set a display name for an item. Setting a display does not change anything in your file system.

To set a display name: