NBA roster files

NBA roster files for Photo Mechanic and GalleryID Desktop

Basketball gives you the one thing football and hockey do not: a clear look at the face and the number on almost every frame. What it takes away is time. An 82-game season with back-to-backs means you are rebuilding a roster file more often than any other sport. SnapCaption gets it down to about a minute, and the file loads into Photo Mechanic and GalleryID Desktop.

Free. No account required to build and download a file.

What makes NBA rosters painful by hand

Every sport breaks a roster file in its own way. These are the ones that bite in NBA.

The deadline rewrites both rosters

A trade can move four players between the two teams you are shooting tomorrow. Pull the roster on game day instead of patching a file you built in November.

Two-way and 10-day contracts

Call-ups arrive with numbers you have never seen and leave again in a week. They are in the roster when you pull it, which is the only way to stay ahead of them.

Volume, not difficulty

No single NBA roster is hard. Doing it eighty times a season is. That is the part worth automating.

One file, both applications

The export is not locked to one program. The same NBA roster file loads into Photo Mechanic and into GalleryID Desktop, with identical shortcodes either way.

Photo Mechanic

Edit > Settings > Set Code Replacements > Load, then pick the file. The shortcodes are live in the caption fields immediately.

Code Replacement is the name Camera Bits, Inc. gives the feature in Photo Mechanic's own documentation, which is why this file is often called a code replacement roster file.

GalleryID Desktop

Attach the same file as a roster and the identical shortcodes expand while you caption. Nothing about the export changes.

GalleryID Desktop goes further than shortcodes — it identifies athletes by facial recognition and writes the names into the photo, so there is no code to type at all. See GalleryID Desktop

What a shortcode looks like

You type
h23
The caption field shows
Marcus Cole, #23, Forward, Riverdale Wolves

The h is the prefix you assigned the home team, 23 the jersey number. Give the visitors their own prefix and both rosters live in one file all night. Coaches get separate codes because they have no number.

What goes in your NBA file

You choose the columns. The export is a tab-separated file, so anything that reads a tab-delimited roster can use it.

  • Full name, first name and last name as separate columns if you want them
  • Jersey number written as 23, #23 or (23)
  • Position as an abbreviation, lowercase, or title case
  • Team name
  • Long-form caption strings, for example: Marcus Cole #23 of the Riverdale Wolves

NBA teams you can build a roster file for

30 teams, kept current from in-season sources. Pick any two and build one file for the whole game.

  • Atlanta Hawks
  • Boston Celtics
  • Brooklyn Nets
  • Charlotte Hornets
  • Chicago Bulls
  • Cleveland Cavaliers
  • Dallas Mavericks
  • Denver Nuggets
  • Detroit Pistons
  • Golden State Warriors
  • Houston Rockets
  • Indiana Pacers
  • LA Clippers
  • Los Angeles Lakers
  • Memphis Grizzlies
  • Miami Heat
  • Milwaukee Bucks
  • Minnesota Timberwolves
  • New Orleans Pelicans
  • New York Knicks
  • Oklahoma City Thunder
  • Orlando Magic
  • Philadelphia 76ers
  • Phoenix Suns
  • Portland Trail Blazers
  • Sacramento Kings
  • San Antonio Spurs
  • Toronto Raptors
  • Utah Jazz
  • Washington Wizards

NBA roster file questions

How do I load an NBA roster file into Photo Mechanic?

In Photo Mechanic, go to Edit > Settings > Set Code Replacements, click Load, and select the downloaded file. GalleryID Desktop attaches the same file as a roster and expands the identical shortcodes while you caption.

How current are the rosters?

Rosters sync from current-season sources, so a file built on game day reflects the roster that morning rather than whenever a spreadsheet was last maintained.

Can I put both teams in one file?

Yes, and it is the normal way to work a game. Assign each team its own prefix and export once, so there is no file to swap at halftime.

Are coaches included?

Yes. Coaches and staff get their own shortcodes rather than jersey-number codes, since they have no number to key off.

Build your NBA roster file

Pick your teams, set your codes, download the file. Free, and no account required.

Open the roster builder