Skip to content

Browser

The Browser allows you to browse files related to assets and shots. To look for files:

browser_structure

  • Select the entity type 1⃣
  • Select your asset/shot 2⃣
  • File Kinds 4⃣ are grouped under tasks 3⃣

  • Selecting an asset/shot document and a File Kind triggers a file search: all files matching the naming convention appear on the right-hand side 5⃣.

    Warning

    This also means that files that do not strictly match the naming convention will not appear.

    browser_no_match

Selection

Searching for files with a single document selected will reveal all the files for that specific document.

browser_selection_single

If multiple documents are selected, the Browser will show the last file found for each document.

browser_selection_multiple

Selecting Multiple Documents

The Documents and Files columns have an extended selection mode; the following shortcuts are available:

  • Ctrl + click -> additive selection
  • Shift + click -> contiguous selection
  • Ctrl + A -> Select all
  • Shift + up/down arrow -> Extend selection up/down
  • Ctrl + Space -> Unselect last selected item

Filters

The Browser includes several filtering options to help you find documents.

Name Filter

The name filter looks for document names that contain the search string and is case-insensitive. For instance:

  • CAT will return catherine and blackCat

  • er will return terry and pepper

    browser_filter_name

Tip

Multiple search strings can be used at once, using the ; separator:

  • CAT;ry will return catherine, blackCat, terry and curry

Field Filter

Field filters let you filter documents by attributes other than their name. The filters are ordered from the less specific to the more specific, which helps you narrow your query.

browser_filter_fields

Tag Filter

Tags are a more "freeform" way of sorting documents, as opposed to fields which are mandatory attributes of documents.

Click one or more tags to reveal documents that have any of the selected tags.

tags_example

Selecting Multiple Tags

The Tag filter has an extended selection mode; the following shortcuts are available:

  • Ctrl + click -> additive selection
  • Shift + click -> contiguous selection
  • Ctrl + A -> Select all
  • Shift + left/right arrow -> Extend selection up/down
  • Ctrl + Space -> Unselect last selected item

Actions

Various actions can be performed on elements in the Browser. BluePepper includes a few handy actions out of the box. Feel free to try them.

browser_action_document browser_action_file

When clicked, actions will run for all selected documents.

Please note that some actions (mainly the time-consuming ones) will start a Batcher job. For more information, see the Batcher Documentation

Tags

Who should manage tags?

In a team project, it's recommended that supervisors manage tags: some tags are used only for filtering, while others may be used to configure actions and tools.

Creating and Adding Tags to Documents

Tags can be added to asset or shot documents by right-clicking the document and selecting Add Tag.

add_tag_0

You may use existing tags or create a new one if needed.

add_tag_1

The appearance of a tag is fully customizable.

add_tag_2

The Pick Icon button opens an Icon Browser window where you can use the search bar and double-click the icon to confirm your choice.

add_tag_3

When done, press OK to apply the tag and you will be able to filter documents using the newly created tag.

add_tag_4

Removing a Tag From a Document

Tags can be removed from a document by right-clicking the document and selecting Remove Tag.

remove_tag

Editing and Deleting Tags

Tags can be edited or deleted by right-clicking them.

edit_remove_tag

When deleting a tag, you will be prompted if the tag is applied to one or more documents.

remove_tag_warning

Multiple Documents, Multiple Tags

Both documents and tags support extended selection mode: you may apply multiple tags to multiple documents in one go.

add_tag_5

Tag Managers

The tag manager can also be accessed from the Launcher.

asset_tag_manager

Tips And Tricks

Prefilled Naming Conventions

Need to create a file but unsure about its naming convention?

The built-in Copy Path and Copy File Name actions send prefilled names that respect the naming convention to your clipboard.

For instance, if you do this:

copy_file_name

pressing Ctrl + v will paste this: beerCanSixPack_mdl_v{version}_{description}.blend

Reading a Document's Content

You can hover over documents to display the full document.

browser_hover_document

Advanced Document Search

If you feel like a power user, the search bar also handles mongoDB queries 💪

  • {"asset": "sprite"} will return documents where the asset key is exactly "sprite"
  • {"asset" : {"$ne" : "spider"}} will return all documents in which the asset key is not "spider".