# Catalogs
Each time a tape is mounted, Canister will create a Catalog of its contents. This makes it easy to find what's on a tape without having to mount it first.
## The LTO Archive volume
On a Mac, when Canister is open, all Catalogs are available as a virtual drive called `LTO Archive`. Since a driver installation is required, Canister will prompt you to install it. You can also [download the installer](https://downloads.hedge.video/canister/catalog/Canister%20Catalog.pkg) directly from our servers.
{% hint style="info" %}
Don't see the LTO Archive volume? Check if your user has administrator permissions.
{% endhint %}
## Creating Catalogs
Canister automatically creates a Catalog the first time it mounts each tape and updates existing Catalogs on subsequent mounting of the tape. Also, after each Archive transfer, the Catalog for that tape is updated automatically.
## Finding files using Catalogs
{% tabs %}
{% tab title="macOS" %}
On macOS, Catalogs live in Finder so you can utilize all the power of Finder's search.
When Canister is open, you'll see the `LTO Archive` mount in Finder. You can also click the Catalog icon in Canister to go there. There, you can do a Finder search. Just hit Command-F and be sure to select `LTO Archive` as the scope. Pro-tip for online/offline workflows: use Smart Folders.
Here's an example of a search for the file `Quitter.zip`, with Finder indicating it's located on LTO tape "A":
{% endtab %}
{% tab title="Windows" %}
On Windows, Catalogs can be accessed by clicking the Catalog button pictured below.
The Storage Browser will open. It provides a useful overview of all tapes in the Catalog. Folders can be expanded by clicking the `>` button.
{% endtab %}
{% endtabs %}
## Retrieve from Finder
On macOS, Canister installs a Finder extension that allows you to retrieve a file or folder directly from the Catalog. Right-click the folder you want to retrieve and select "Retrieve" to launch Canister. This will trigger Canister to check if the correct tape is mounted and automatically select the required files. Then, Canister will ask to specify a location to retrieve to.
## Catalog History
Canister creates a Catalog when mounting a tape and updates it after each Archive. Catalog history is stored for safekeeping as described below.
{% tabs %}
{% tab title="macOS" %}
Old Catalogs are moved into a *hidden* folder named `Tapename (serial).history`, essentially archiving them.
{% hint style="info" %}
To see previous generations of your Catalogs, enable Show Hidden Files in Finder with the shortcut `Shift-Command-.`
{% endhint %}
{% endtab %}
{% tab title="Windows" %}
The most up-to-date Catalog is stored in: `/Users/Username/AppData/Roaming/Canister/$TAPE/Current`
Previous versions of a Catalog are stored in:\
`/Users/Username/AppData/Roaming/Canister/$TAPE/History/YYYY-MM-DD`
{% endtab %}
{% endtabs %}
## Editing and removing Catalogs
Use the steps below to clean up the Catalog, or remove test entries:
{% tabs %}
{% tab title="macOS" %}
To access the catalogs location, bypassing the virtual drive, `Alt-Click` the Catalog icon in Canister (top-right) and a folder in `~/Library/Application Support/Canister` will open with editable catalogs.
{% endtab %}
{% tab title="Windows" %}
Navigate to`/Users/Username/AppData/Roaming/Canister/Catalogs` using Explorer, then either delete the folder representing tape you wish to remove.
{% endtab %}
{% endtabs %}
## Changing the Catalog location
{% tabs %}
{% tab title="macOS" %}
On macOS, it's possible to set a custom Catalog location using a User Default.
1. Open Terminal.app and enter `defaults write nl.syncfactory.Canister.Mac CatalogLocation` followed by the full path of the folder, all on one line.\
\
eg.\
\
`defaults write nl.syncfactory.Canister.Mac CatalogLocation /Users/[username]/Documents/Canister/Alternative\ Location`
{% hint style="info" %}
Pro-tip: don't type the folder path, but drag the folder you want as location for Catalogs from Finder into the Terminal.
{% endhint %}
**Note:** when checking for a User Default value for the Catalog location, Canister expects a full path, including the name of the Catalogs folder itself. If a path is unreachable (e.g., if on a network server or cloud drive) or Canister doesn’t have the correct permissions, Canister will use the default Catalog location.
{% endtab %}
{% tab title="Windows" %}
On Windows, it's possible to set a custom Catalog location using a Registry Switch.
1. Open Registry Editor.
2. Locate Canister here: `Computer\HKEY_CURRENT_USER\Software\Canister`
3. Right Click to create a new String Value called `AlternativeCatalogLocation`.
4. Define your full path including the drive letter.
5. Restart Canister.
{% endtab %}
{% endtabs %}
## Migrating to a new system
In the event you need to move to a new computer, Catalogs can be moved as follows:
{% tabs %}
{% tab title="Mac" %}
Due to the typically large amount of files in a catalog, it's best not to copy catalogs but to archive them first.
Run this command in Terminal, and it will create an archive on your desktop:
```
tar -cvzf ~/Desktop/catalogs.tar.gz ~/Library/Application\ Support/Canister/Catalogs
```
You can copy this archive to a new machine, then unpack it with a free app like [Unarchiver](https://apps.apple.com/us/app/the-unarchiver/id425424353?mt=12).
{% endtab %}
{% tab title="Windows" %}
Navigate to `/Users/Username/AppData/Roaming/Canister` using Explorer, then right click the `Catalogs` directory and choose `Send to` -> `Compressed (zipped) folder`.
Next, copy the zip to the new computer and extract.
{% endtab %}
{% endtabs %}
## Converting with NeoFinder
NeoFinder for Mac offers integrations between many other LTO-focused apps (eg. YoYotta, PreRoll Post) and Canister, making it a breeze to convert your old databases to Catalogs. For more information, refer to NeoFinder's [documentation](https://www.cdfinder.de/guide/10/10.2/hedge_canister_export.html).
## Importing StorageDNA Catalogs
Users with StorageDNA LTFS Catalogs can use [this script](https://downloads.hedge.video/canister/scripts/migrate_sdna_to_canister.sh) to convert them into Canister Catalogs.
{% hint style="info" %}
This script requires the `fileicon` utility to be installed first, via [brew](https://brew.sh/).
{% endhint %}
1. Zip the `archive.xml` and `catalog.tgz` files representing each of your SDNA Catalogs, then place the resulting zip file into a folder named after the Catalog.
2. Place the converter script on the same level as the folders containing your zip files, e.g.,
3. Run the script in `Terminal.app`:\
`./migrate_sdna_to_canister.sh`
4. Copy the newly created Canister Catalogs stubs from the `_processed` directory to\
`~/Library/Application Support/Canister/Catalogs`
