# File Explorer Plugin
## Overview
The File Explorer Plugin is a plugin made, published, and officially supported by Ango AI that allows you to browse a folder in your AWS S3 bucket and quickly import it into Ango Hub.
## Plugin Functionality
The plugin hooks into your AWS S3 private buckets and allows you to bulk import a folder of your choice in the bucket. Optionally, you can assign all assets imported this way to one or more specific batches, it has duplicate prevention, and more.
## Using the File Explorer Plugin
From the Plugin Directory, search for *File Explorer Plugin* and install the plugin to your organization. More information on installing plugins can be found on the Installing Plugins page.
### Usage
First, ensure you have created a storage integration between Ango Hub and the private assets where the files you wish to import are being stored. [More information on how to do so can be found here](/data/storages/importing-private-cloud-assets-aws.md).
Then, navigate to the project where you'd like to import the assets.
Enter the *Settings* tab, then the *Plugins* section.
Find the *File Explorer Plugin* and click on *Open.* A dialog will appear:
From the *Storage* dropdown, pick the storage to the bucket from which you wish to import the assets.
In the *Bucket Name* area, type in the full name of the bucket you are connecting to. For example, `acme-private-assets`.
Then, click on *Select Folder*. A dialog will pop up, from which you will be able to pick a folder, from within your bucket, to import. Navigate to the folder you'd like to import and press *Select Current Folder.*
In *Batch*, you may pick one or more batches to which assets imported in this session will be assigned.
In the Config JSON area, you can tweak a number of settings. By default, they are:
```json
{
"upload_subfolders": false,
"prevent_duplicates": false,
"assign_folder_names_as_batch_name": "do_not_assign",
"accepted_extensions": [],
"ignored_extensions": [],
"start_index": null,
"end_index": null,
"video_frame_step": null,
"video_frame_rate": null
}
```
* `upload_subfolders`: Enabling this will cause the plugin to import all files, recursively, including those in subfolders.
* Example: `"upload_subfolders": true`
* `prevent_duplicates`: Enabling this will prevent the plugin from importing an asset, if an asset with the same name already exists in the project.
* `assign_folder_names_as_batch_name`: Enabling this will assign each asset a batch depending on where it was located. For example, if the asset was located in the `plugin-import/nifti` folder, that will be its batch name. You don't need to create the batches in advance -- the plugin will create them for you.
* `accepted_extensions`: Whitelist here the extensions of the files you wish to import. For example, adding ".jpg" or "jpg" will import only files ending with the ".jpg" extension.
* `ignored_extension` works similarly, except it's a file extension blacklist.
* `start_index` and `end_index`: By setting the start and end indexes, you may choose to only upload a section of the data in the folder. Index values start at 0 and end with the total number of assets. Setting an index to `null` equals setting it to the first (in the case of `start_index` or the last (in the case of `end_index`) asset in the list. Setting both to `null` uploads all assets.\
For example, assuming your assets are `Asset-1`, `Asset-2`, ... `Asset-10`,\
\
start\_index = 1, end\_index = 4 → uploads Asset-2, Asset-3, Asset-4
start\_index = null, end\_index = 4 → uploads Asset-1, Asset-2, Asset-3, Asset-4
start\_index = 1, end\_index = null → uploads Asset-2, Asset-3, …, Asset-10
start\_index = null, end\_index = null → uploads Asset-1, Asset-2, …, Asset-10
Click on *Run.* The assets will be added to your project.
You may check the progress of the conversion from the *Plugin Sessions* dialog. More information on checking plugin progress [here](/plugins/introduction-to-plugins/monitoring-plugin-progress.md).
{% hint style="info" %}
If the assets do not appear, it might be because you have reached your organization's asset limit. Make sure to check the *Usage* tab of your [Organization page](https://hub.ango.ai/organization).
{% endhint %}
{% hint style="info" %}
Depending on the number and size of the assets, it may take a long time for the assets to appear in your project. You may check the progress from the [*Plugin Sessions*](/plugins/introduction-to-plugins/monitoring-plugin-progress.md) dialog.
{% 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.imerit.net/plugins/first-party-ango-plugins/file-explorer-plugin.md?ask=
```
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.
