Docs/Organize Photos into Folders

Organize Photos into Folders

After analysis, RaceTagger can automatically organize your photos into folders β€” one folder per race number or participant. No more manual sorting through thousands of photos.

After an analysis finishes, RaceTagger can automatically sort the analyzed photos into folders β€” one folder per race number, per named participant, or by a custom pattern (team, category, or a mix). Instead of scrolling through thousands of tagged photos to hand-sort them, you run one organize pass and get a folder tree ready to hand off or upload. A photo with several race numbers in it (a group shot, a podium) is copied into every matching folder, not just the first one. Photos where the AI found no number, and frames the app skipped as generic scene content, each get their own catch-all folder so nothing silently disappears.

How to use it

  1. 1From the results view for a finished analysis, open πŸ“ Organize Photos into Folders β†’ βš™οΈ Configure & Organize:
  2. 2Pick an Operation Mode: πŸ“‹ Copy files (creates organized copies, keeps the originals β€” checked by default) or πŸ“¦ Move files (relocates the originals into the organized folders).
  3. 3Pick a Folder Naming Pattern: πŸ”’ Number only (42/), or β€” only shown when a participant preset was used for the analysis β€” πŸ‘€ Number + Name (42 John Doe/). A per-participant Custom Folders pattern (with {number}/{name}/{team}/{category}/{tag} placeholders) can also be set on the preset itself β€” see the "preset-folders-and-destinations" page.
  4. 4Pick a Destination: πŸ“‚ Source folder (creates an Organized_Photos folder next to your images) or πŸ“ Custom destination (Browse to any folder).
  5. 5Pick a File Conflicts strategy: πŸ”„ Rename automatically (default) or ⏭️ Skip duplicates.
  6. 6Optionally turn on ✏️ Rename files using a pattern and edit the filename pattern (default…: {number}_{name}_{team}-{seq:2}; chips for {number}, {name}, {surname}, {team}, {car_model}, {nationality}, {event}, {date} and more insert the placeholder at the cursor).
  7. 7Click πŸš€ Start Organization: A summary reports how many photos were organized, into how many folders, and how many were skipped or landed in the unknown/others folders.
  8. 8Organizing is not tied to when analysis finished β€” run it later, and re-run it with different settings; the analysis…: results themselves are never touched by this step.

Limits and known behaviour

  • Copy mode is reversible β€” the originals are untouched, so you can just delete the organized folders and try again with different settings. Move mode is not: once files are moved, the app blocks re-running organization for that analysis ("Files have already been moved for this execution... Use 'Copy' mode instead if you need to reorganize") because the originals are no longer at the paths the analysis recorded.
  • Multi-number photos land in every matching participant's folder β€” the photo is copied once per detected number/participant, not just the first match, so nobody's folder is missing a shot everyone else has.
  • No number detected β†’ the photo goes to the Unknown_Numbers folder (configurable name; default Non_Riconosciuti when the field is left empty entirely, Unknown_Numbers in the UI's default config).
  • Frames the app skipped as generic scene content (crowd shots, paddock, podium celebration with no tagged number) go to an Others folder β€” separate from Unknown_Numbers β€” unless you've since manually assigned that frame a number or a name, in which case it's treated as identified content and organized normally rather than buried in Others.
  • Numberless participants (a team principal, a VIP, a mechanic β€” added to a preset with a name but no race number) route by name instead of number: if you've assigned that person to a photo (by AI face match or by manual correction), the photo goes to their custom folder(s) from the preset instead of falling into Unknown_Numbers.
  • A participant's custom folders always win over Unknown_Numbers/Others when one applies β€” but a participant can also opt out of getting the number-only folder in addition to their custom ones (include_default_folder on the preset). If a participant has no custom folder and has opted out of the default one, their photos route to Unknown_Numbers rather than being forced into a folder they asked not to use.
  • Phantom numbers are filtered when a participant preset is active: a detected number that isn't in the preset's list is routed to Unknown_Numbers instead of creating a stray folder β€” this is a defense-in-depth check, not something you configure per run.