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:

- Choose View > Toggle File Shelf.
- Click the Up/Down arrow button in the upper right corner of the window.

## A and B

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

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

- Click on an unmarked item in the File Shelf and select "Set as A" or "Set as B" from the options that appear.
- Click on a marked item in the File Shelf and select "Swap with A" or "Swap with B".
- Go to the Edit menu and choose one of the selection options.
- Use the arrow keys on the keyboard to move the selection forwards and backwards.
- Click the Next or Previous buttons in the mini-toolbar on the far right of the File Shelf to move the selection forwards and backwards.

## File Shelf Item Actions

Click the "Action" button in a file shelf item to choose from the following 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.
Remove
  Removes the item from the File Shelf.

## Reordering, Removing and Adding Items

You can reorder the files by dragging them.

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

- Click on the "Action" button on the item and choose "Remove" from the menu.
- Click on the item to highlight it and press the delete key on the keyboard.

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

- Click on the "Add" (+) button on the mini-toolbar on the far right side of the File Shelf.
- Double-click on an empty portion of the File Shelf.
- Right-click on an empty portion of the File Shelf and choose "Add Item" from the contextual menu.