Skip to content
This repository was archived by the owner on Oct 28, 2026. It is now read-only.

Using the Grid

speedyrulz edited this page Oct 26, 2026 · 1 revision

Using the Grid

Editing a caption in the grid

Adding images

Action How
Add individual images Add Images… (Ctrl+O)
Add a folder Add Folder… (Ctrl+Shift+O): images directly inside the folder
Add a folder and its subfolders File ▸ Add Folder (with subfolders)…
Drag and drop Drop files or folders on the window. Folders dropped this way include their subfolders.

Supported formats: JPG, JPEG, PNG, WebP, BMP, GIF, TIF, TIFF. Images already in the list are not added twice, and the list is sorted in natural order (img2 before img10).

Removing images from the list never deletes files on disk.

Each card

  • Thumbnail with a coloured status dot (see below)
  • File name
  • Caption box: the contents of the matching .txt file

Status dots

Colour Meaning
Green Has a caption
Amber No caption yet
Purple Queued for captioning
Blue Being captioned right now
Red Captioning failed (see View ▸ Log)

Editing captions

  1. Click inside the caption box of a card. It turns into a text editor.
  2. Type, delete or paste.
  3. Click anywhere else to finish. The .txt file is written at that moment.

Rules:

  • If the image has no .txt yet, one is created as soon as you add text.
  • Removing text updates the file. If you delete everything, an empty .txt is left in place (some trainers need the file to exist).
  • Clicking into an empty box and leaving without typing does not create a file.
  • Esc while editing cancels the change.
  • Enter starts a new line inside the caption. The single line option in Settings only applies to captions the model generates.
  • Files are saved as UTF-8.

Edits are made directly in your dataset folder, so there is no separate "save" step and nothing is lost if the app closes.

Selecting

  • Click a card to select it. Ctrl+click and Shift+click select several.
  • Caption Selected (Ctrl+Shift+Enter) captions the selection and overwrites existing captions.
  • Remove Selected (Del) takes them out of the list (files stay on disk).

Right-click menu

  • Caption selected
  • Clear caption(s): empties the caption of every selected image (asks first)
  • Show in Explorer: opens the folder with the image highlighted
  • Remove from list

Finding things

The toolbar has:

  • Show: All, Missing captions, Captioned
  • Search: filters by file name or caption text, as you type
  • Thumbnails slider: card size from small to large

Caption All works on what is currently shown. Filter to Missing captions first if you only want to fill gaps (or just leave Skip images that already have a caption ticked).

The status bar shows totals: images, captioned and missing.

Shortcuts

Shortcut Action
Ctrl+O Add images
Ctrl+Shift+O Add folder
Del Remove selected from list
Ctrl+Enter Caption all
Ctrl+Shift+Enter Caption selected
Esc Stop captioning
Ctrl+, Settings

Themes

View ▸ Light mode switches between the dark (black and red) and light theme immediately.

Caption grid, light theme

Clone this wiki locally