Assignr Import

Assignr Import is a command-line app that helps import schedules from Arbiter, GameOfficials, or GotSport into Assignr. Point it at one of those exports and it will tidy the data, remove duplicates, then upload directly to Assignr or produce a CSV you can import yourself.

Quick Start

Requirements

• .NET 8 SDK
• Assignr API credentials (client id and secret)
• A schedule export from Arbiter (TXT), GameOfficials (CSV), or GotSport (CSV)

Configure credentials

cp .env.example .env

Fill in ASSIGNR_CLIENT_ID and ASSIGNR_CLIENT_SECRET, or export them in your shell.

Run one of the helper scripts

Each script is tuned for one importer. Set your environment variables (or add them to .env) and run the script that matches your export:

# Arbiter example
SITE_ID=12345 LEAGUE_NAME="IHSA" IMPORT_FILE="$HOME/Downloads/Schedule.txt" \
./run.arbiter.sh

# GotSport example
SITE_ID=12345 LEAGUE_NAME="My Tournament" IMPORT_FILE="$HOME/Downloads/Schedule.csv" \
./run.gotsport.sh

# GameOfficials example
SITE_ID=12345 LEAGUE_NAME="Soccer Planet" \
IMPORT_FILE="$HOME/Downloads/Game Officials Export.csv" \
./run.soccerplanet.sh

Helpful Flags (customize inside the scripts)

• --venue="Venue Name" – force every row to use the same Assignr venue.
• --canonicalize-venues=true – fetches venues from Assignr and fuzzy-matches imported venue text.
• --assignments=me --my-name="Your Name" – only keep your name in the crew assignments.
• --dedup=false – skip duplicate detection if you want to re-import everything.