> For the complete documentation index, see [llms.txt](https://docs.hedge.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hedge.video/canister/features/retrieving.md).

# Retrieving

Retrieving files from a tape is easy; you can either retrieve a full tape or cherry-pick contents to retrieve just a few files.

Select the `Retrieve` tab. If no tape is loaded, do so first:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2F08pscKdOz6EdHBP5oMLt%2FRetrieve%20Load.png?alt=media&amp;token=643c7c57-c779-49bd-bc27-2b64c8221c22" alt=""><figcaption></figcaption></figure>

Mount the tape:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2F87BAIhXDyPJ2lNd5nI4Z%2FRetrieve%20Mount.png?alt=media&amp;token=c5dc683f-6113-4e16-b31a-d9cacebe6a48" alt=""><figcaption></figcaption></figure>

To retrieve the tape in full select the tape icon, and a border will appear. Click Next and then select a destination, and continue.

To retrieve a specific file, folder, or a collection of files and folders, click the drive menu (three horizontal lines) and select Select Files...

By default, the full tape's contents are selected. Unselect the root of the tape to deselect everything, and then navigate to what you need to be retrieved.

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FLfKsNBB4xLUkXzh8yF3G%2FRetrieve%20Cherry%20Picker.png?alt=media&amp;token=30915d85-3ff4-49b9-8546-21a494f86908" alt=""><figcaption></figcaption></figure>

Hover over the drive to see the size of your selection:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FppRsImsmuYTTyisDKeBI%2FRetrieve%20Selection.png?alt=media&amp;token=83047d46-19ef-4800-9fa3-7832c02bf0a5" alt=""><figcaption></figcaption></figure>

When done, click `Next` then select a Destination:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FC9m4pGooUXIPr6B4qjwO%2FRetrieve%20Destination%20Drop%20Zone.png?alt=media&amp;token=ebc2fa68-1b54-47ed-a28e-1ac3c5d777f6" alt=""><figcaption></figcaption></figure>

Then add the Transfer...

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FE6H8f2p6DV0afjgjGihp%2FRetrieve%20Destination%20Selected.png?alt=media&amp;token=bb83ff5d-34ca-4b25-b897-5058d71828f6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2Fk3fEoxGJRlWkOAvSevcp%2FRetrieve%20in%20Progress.png?alt=media&amp;token=cf23a17d-f467-4702-8fc2-e2cce192041e" alt=""><figcaption></figcaption></figure>

When done, the progress bar turns green:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FGs8kIw9RITEwkovGiDxO%2FRetrieve%20Success.png?alt=media&amp;token=08fe1222-56ef-47b9-b19e-bdb197117850" alt=""><figcaption></figcaption></figure>

Open the accompanying Transfer Log if needed:

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2Fr64X2IvXVi5gsYCoz7MY%2FTransfer%20Logs.png?alt=media&amp;token=4d4ac635-b640-4742-9f57-19f11fe93ca4" alt=""><figcaption></figcaption></figure>

## Independent Transfers

Canister allows multiple LTO drives to be used independently of one another. That means `Drive A` can be Archiving, whilst `Drive B` handles a Retrieve.

## Retrieve with Finder

{% hint style="info" %}
This feature requires macOS Big Sur or newer.
{% endhint %}

Canister for Mac makes it easy to retrieve files using Catalogs. First mount the relevant tape, then locate it the LTO Archive. Finally, select the file or folder you wish to retrieve, right-click and select the "Retrieve..." Finder extension.

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2F7NaYWvJNmyHRNRpEtez5%2FScreenshot%202023-01-17%20at%2009.27.11.png?alt=media&amp;token=76f74427-853e-4ce9-b786-a4e66c6950f4" alt="" width="262"><figcaption></figcaption></figure>

## Retrieve with Full Path

{% hint style="info" %}
Retrieve with Full Path cannot be disabled in Canister for Windows.
{% endhint %}

When checked, files and folders selected for Retrieve will be copied to the destination, including the recreation of full paths as they exist on tape. This is useful when restoring projects that are sensitive to path changes.

Example:`LTO-42/Production X/0001.mov` is to be retrieved to `~/Desktop`

* Without `Retrieve with Full Path` enabled, `0001.mov` will be copied directly to your Desktop.
* With `Retrieve with Full Path` enabled, after retrieving `0001.mov` your Desktop will be populated with a `Production X` folder containing `0001.mov`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hedge.video/canister/features/retrieving.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
