PLAYERBATCH STUDIO — QUICK START

1. Double-click START_PLAYERBATCH.cmd
2. Import or drop your roster CSV.
3. Select the portrait folder, or drop PNG/JPG portrait files.
4. Review flagged athletes and automatic cutouts.
5. For a missing or ambiguous portrait, select the athlete and use Assign / replace.
6. Choose a preset accent or CUSTOM team color.
7. Click Render team ZIP.

RECOMMENDED CSV COLUMNS
name, number, position, class, photo

PORTRAIT MATCHING
- The photo column is used first when it exactly names a file.
- Otherwise PlayerBatch tries normalized exact name/number matches.
- A partial filename match is used only when it resolves to one unique portrait.
- Ambiguous portrait matches are NOT guessed; they are sent to Review issues.
- Missing or ambiguous portraits block batch export until reviewed.
- Use Assign / replace to resolve an exception without renaming the entire portrait folder.

PORTRAITS
- PNG and JPG are supported.
- PlayerBatch performs automatic local background removal for portrait compositing.
- High-resolution source pixels are preserved for print-oriented output.
- Clean, consistently framed Media Day portraits produce the best results.
- Transparent PNG portraits are also supported.

TEAM COLOR
- Four presets are included.
- CUSTOM accepts any color through the native Windows/Edge color picker.
- Extreme light, dark and highly saturated colors are normalized automatically for readable output.
- The selected accent is applied across all four graphic systems.

OUTPUT
- SOCIAL_1080x1350 PNG
- PRINT_2400x3000 PNG
- PLAYERBATCH_EXPORT_MANIFEST.json
- PLAYERBATCH_FAILURES.json
- Duplicate output names are preserved with _02, _03 suffixes rather than overwritten.

WORKFLOW
- Local processing
- Automatic local background removal
- No account required for the app workflow
- No Photoshop required
- No recurring subscription required
- Four built-in sports visual systems

WINDOWS
PlayerBatch Studio uses Microsoft Edge app mode. Microsoft Edge must be installed on the Windows PC.

TIPS
- Keep portrait filenames consistent with the roster photo column.
- Use Review issues before export.
- Adjust Horizontal / Vertical / Zoom only for athletes that need correction.
- Better source portraits produce better final graphics.
