# Browse Storage

The first place to start finding media in Nara is via the **Browse Storage** mode.\
You can find this option on the [left side](/using-the-app-core-features/editor.md#left-panel) of your user interface.&#x20;

<div align="left"><figure><img src="/files/CcrNglVEZyYzlJEPQP7J" alt="" width="272"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
This feature is controlled by the system administrator - if you do not see this option or it is greyed out, please contact your system administrator.&#x20;
{% endhint %}

Once you have this mode selected you can browse media across any of the storage available to you in Nara.&#x20;

## Storage Navigator

When Browse Storage mode is active, the top part of the middle panel will show the storage navigator.

Clicking on the Volume selector button at the top left corner of the storage navigator will give you a drop-down list of all the volumes that you have permission to access:

<div align="left"><figure><img src="/files/10n2ahV68Yn1ySERIJJ8" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
These volumes are configured by your system administrator - if you do not see the correct volumes, please contact your system administrator.&#x20;
{% endhint %}

Once you have selected the media volume, you will then have the ability to browse it's folder structure. Nara's navigator works very similarly to any other column-based file browser - clicking on a folder will show its contents in the next column to the right:

<div align="left"><figure><img src="/files/KBPtsHmCIKsDymIb4oK2" alt=""><figcaption></figcaption></figure></div>

Each folder in the selected path is highlighted in blue. Horizontal and vertical scroll bars allow you to move the view around if there are more folders or columns than will fit on the screen. Note that you can also drag the lower edge of the navigation window to expand it downwards.

### Column Filter Button

If there are many items in the current column you can enable a text filter by clicking on the 'F' button at the top of the column. The 'F' will turn red showing you that the filter is enabled and open a text box. Only items with text matching what you type into the filter box will be shown, as in the example below (note that the text-matching is not case sensitive):

<div align="left"><figure><img src="/files/gpPs9ZAsEG05WDhRWOZN" alt="" width="563"><figcaption></figcaption></figure></div>

To clear the filter, click on the red 'F' button to toggle it off. The text-match field will disappear.

### Path Button

At the top of the navigator is a long button which contains the complete path from the root of the volume to the current folder. If you click on this button you will see a drop-down of all the intermediate folder levels - click on them to navigate back up to a specific sub-folder level:

<div align="left"><figure><img src="/files/JUXaCzIJiO8h23iPbZ4D" alt=""><figcaption></figcaption></figure></div>

### Go to Folder

If you know the folder or directory you want to browse, you can enter it's path diferectly by clicking on the **Go to a directory** button at the right-hand end of the top bar:

<div align="left"><figure><img src="/files/cBGwEHBvgx06z4MBSrJH" alt="" width="170"><figcaption></figcaption></figure></div>

This will bring up an entry box showing the entire path to the current folder - edit this path or type in a completely different path to jump directly to the point where you want to browse for media, then click on the **Go** button in the pop-up box.&#x20;

### Volume Index Status

Nara has a powerful media index which stores all the metadata for your media. The status of the index for the current volume is indicated by the star button to the right of the long path button:

<table data-header-hidden><thead><tr><th width="95"></th><th></th></tr></thead><tbody><tr><td><img src="/files/j7E4pu7u7Loq7XhOpO6r" alt=""></td><td>Index OK</td></tr><tr><td><img src="/files/FNZoxjrVvWcgzuSE7P3f" alt=""></td><td>Index not available</td></tr></tbody></table>

{% hint style="warning" %}
The Nara index is an option. Please contact your system administrator if you think it should be available but does not appear to be working.
{% endhint %}

### Hiding the Storage Navigator

Once you have navigated to the folder you are intereseted in, you can hide the Storage Navigator (upper part of the browser) by clicking on the Show/hide browser toggle button - the icon is grey when the Storage Navigator is hidden.&#x20;

<div align="left"><figure><img src="/files/XI3FwTTVw4VRXJ281MBB" alt="" width="250"><figcaption></figcaption></figure></div>

Hiding the upper panel gives more space for the thumbnails or column view.

## Current Folder

The current folder is the one at the end of the path shown in the [path button](#path-button), or the right-most blue-highlighted folder in the navigator columns.

Media files in the current folder are shown either as a [grid](/using-the-app-core-features/markdown/sequence-grid.md) of thumbnails or as a vertical [list](/using-the-app-core-features/markdown/sequence-list.md) in the [media browser window](/using-the-app-core-features/markdown.md) directly below the navigator.

{% hint style="info" %}
If there are no files in the current folder then the summary in the bar at the top of the media browser will say "Nothing in..." \<the current folder path>
{% endhint %}

The current folder can be added to the currently active project providing a quick way to group together media related to a specific project. To add the current folder to a project, first make sure that the correct project is currently active (the project will be highlighted with a grey background in the [project list](/using-the-app-core-features/projects.md)) and then click on the '+' button next to the project name:

<div align="left"><figure><img src="/files/C9X372nqCPP49rOAiOsi" alt="" width="205"><figcaption></figcaption></figure></div>

A pop-up box will ask you to provide a name for the folder and show you its path:

<div align="left"><figure><img src="/files/AP2aH27cMwfkvvBkcTbf" alt="" width="563"><figcaption></figcaption></figure></div>

Click on the **Ok** button to confirm or **Cancel** if you decide not to add the folder. Note that folders can easily be removed from the list in the project - see the [Project Folders](/using-the-app-core-features/projects/project-folders.md) section for more details.

### Filter Button

If you only want to show media files which contain specific text in their name, click on the **Filter by name** button which can be found in the group of buttons at the right-hand side of the bar at the top of the media browser grid/list view:

<div align="left"><figure><img src="/files/SU1SSYlmEjqQQNPPuXGi" alt="" width="165"><figcaption></figcaption></figure></div>

When you enable the filter button a box will pop up allowing you to enter a text string to filter by - only files with names which contain the text will be shown in the browser window. Note that the text filter is not case sensitive.

{% hint style="info" %}
Note that this filter behaves slightly differently to the column filter. When it is active the button does not turn red and the filter text box is not visible. To clear the filter, click on the [refresh button](#refresh-button) - this will reload the thumbnails for the current folder and clear any filter which may have been set.
{% endhint %}

### Refresh Button

Clicking on this button (curled arrow) will reload the thumbnails for the current folder. This is useful if the folder contents have changed while you have been viewing the folder and they may not yet have automatically updated.

<div align="left"><figure><img src="/files/Gglq69uzdIJf9Lvmx5gF" alt="" width="137"><figcaption></figcaption></figure></div>

### Descend Folders

By default, the browser view only displays thumbnails for media files located directly within the selected folder - it won't show you any of the media files in sub-folders. In order to see thumbnails for **All** files in the current folder **and all the subfolder levels below** this point you need to enable the **Descend** button located in the group of buttons at the right-hand side of the media browser top bar:

<div align="left"><figure><img src="/files/I64VIoYFgXAS1U5OdT5p" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
If you enable the descend option at a high level in your folder structure, there may be a huge number of media files to display. Although Nara can handle a great number of thumnails it may take a while for them to appear if you are browsing an un-indexed storage volume.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nara.stream/using-the-app-core-features/browse-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
