Gallery View

Gallery View

Gallery View is the central hub of Bitcrush Studio. It gives you an overview of every image in the current dataset and provides quick access to filtering, sorting, batch operations, captions, tags, quality scores, and image management tools.

Use the controls in the top-right corner to change how the dataset is displayed or narrow the gallery to specific types of images.

Detailed View

Right-click any image in Gallery View to open its Detailed View.

Detailed View lets you inspect and manage the selected image without leaving the gallery. From here, you can:

• View and approve captions.
• Restore captions previously associated with the image.
• Inspect tags and scores.
• Flip, rotate, or crop the image.
• Move, copy, validate, or delete the image.

Captions

Each line in the caption editor represents a separate caption associated with the image.

Caption lines are colour-coded by type. In the example above:

• The first line is a descriptive caption.
• The second line is a short caption.
• The third line is a tag-style caption.

See the Captioning page for more information about caption types and how Studio classifies them.

Approved Captions

Select the checkbox next to a caption line to approve it.

An approved caption becomes permanently associated with that image within Bitcrush Studio, unless you later remove its approval. If Studio encounters the same image again, it can restore the approved caption even when:

• The image has been moved to another dataset.
• The external caption file has been deleted.
• The caption has been lost during a file operation.
• The caption has been edited outside Bitcrush Studio.

Because approved captions can follow the image across datasets and file locations, approval should generally be reserved for captions that have been checked and verified by a person.

Pending Captions

When Studio detects an image that it has indexed previously, it may find captions that were associated with an earlier copy of that image.

These captions appear as Pending Captions, allowing you to add them to the current copy without rewriting or regenerating them.

This works across different folders and datasets, provided Studio recognises the underlying image.

Approved captions do not require manual restoration and are added automatically when the image is recognised.

Quick Tools

The quick tools beneath the image provide common editing operations without opening a separate editor.

You can:

• Flip the image horizontally or vertically.
• Rotate the image.
• Quickly crop the image.

Changes made through these tools are applied directly to the selected image.

Actions

Detailed View also provides several file-management actions:

• Delete: Deletes the selected image.

• Validation: Moves the image into a val folder inside its current subfolder. If the folder does not already exist, Studio creates it automatically.

  For example, an image in Animals/Dogs will be moved to Animals/Dogs/val.

• Move: Moves the image into another subfolder.

• Copy: Copies the image into another folder or dataset while keeping the original in place.

• Unsorted: Moves an incorrectly categorised image into the global Unsorted folder. You can later use the Sort Tool from the main toolbar to assign it to a more appropriate location.

Filters and Sorting

The controls in the top-right corner of Gallery View let you change the image order or restrict which files are currently visible.

These controls only affect how files are displayed in Gallery View. They do not move, rename, or modify the underlying files.

Sort

Images can be sorted using the following options:

• Default: Sorts images by filename.

• Quality Score: Sorts images using quality scores assigned through Studio's review tools or generated through the Quality Tool's AI or simple scoring modes.

• Resolution: Sorts images by their pixel resolution.

• Aspect Ratio: Sorts images according to their width-to-height ratio.

• File Type: Groups or sorts files according to their file format.

• Random: Randomly shuffles the order of the displayed images.

Filter

Filters can be used to show or exclude files based on their captioning state or media type.

Available filters include:

• Images with approved captions: Shows images containing at least one approved caption.

• Images with captions: Shows images containing one or more captions.

• Images with tags: Shows images with tags associated through Bitcrush Studio.

• Images: Shows still-image files.

• Videos: Shows video files.

Multiple filters can be combined to narrow Gallery View to the files you currently want to review or manage.