TribeSync

TribeSync helps CodeTribe staff add student locations to Zoom attendance spreadsheets automatically.

What it does

1. Upload applicants — import the master applicants file once (or when it changes)
2. Upload session — import a Zoom attendance file after each session
3. Export data — download the enriched file with locations filled in (CSV, TXT, or Excel)
4. Check unresolved — pick a session, see who did not match, and export that list

If someone’s Zoom email does not match the applicants list, TribeSync flags them as unresolved so you can follow up.

Before you start

• Install Node.js 20+ from nodejs.org — that’s all you need
• Ask your CodeTribe admin for the setup code

No separate TribeSync install required. Use npx — it runs TribeSync directly from npm each time.

Run TribeSync (recommended)

Open a terminal and run:

npx tribesync

First run may take a few seconds while it downloads — after that it starts quickly.

Other commands:

npx tribesync configure    # change setup code
npx tribesync --help       # show commands

After each session

1. Export the attendance file from Zoom (CSV or Excel).
2. Open a terminal in the folder where the file is saved:

cd path\to\your\files
npx tribesync

3. Choose Upload Zoom session CSV — enter the session name and date, then pick your file.
4. Choose Export data to download the enriched file.
5. If there are unresolved attendees, TribeSync will offer to download that list separately.

You can also run Check unresolved attendees from the menu anytime to review a past session.

When applicants change

Run npx tribesync, choose Upload applicants CSV, and select the latest file from Google Forms.

First-time setup

1. Run:

npx tribesync

2. When prompted, paste the setup code from your admin.
3. Done — you only need to do this once on each computer.

To change the setup code later, pick Configure database connection from the menu, or run npx tribesync configure.

Optional: install globally

If you prefer typing tribesync without npx:

npm install -g tribesync
tribesync

Windows: tribesync not recognized?

Only needed if you installed globally. Run this once in PowerShell, then close and reopen your terminal:

[Environment]::SetEnvironmentVariable(
  "Path",
  [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:APPDATA\npm",
  "User"
)

Or skip the install and keep using npx tribesync — no PATH fix needed.

File types

• CSV (.csv)
• Excel (.xls, .xlsx)

Use the same file formats you already export from Zoom and Google Forms — no need to rename columns.

Troubleshooting

| Problem | What to do | |---------|------------| | Command not found | Use npx tribesync instead of tribesync | | tribesync not recognized (global install) | See Windows fix above, or use npx tribesync | | Setup not complete | Run npx tribesync and follow the first-time setup | | Cannot connect | Check the setup code with your admin | | Missing columns in file | Use the standard Zoom or Google Forms export — ask your admin if unsure | | Something went wrong | Contact your CodeTribe admin |

Need help?

Contact your CodeTribe admin for setup codes, access issues, or file format questions.