Seed Tracker

Matches {id}.torrent files against your qBittorrent session and updates NocoDB with your username. Can also upload CSVs generated by others via --upload-csv.

Requirements

• Python 3.10+

Usage

API Mode (updates NocoDB directly)

python xb_seed_status.py \
  --id-folder ./torrents \
  --bt-backup ~/.local/share/qBittorrent/BT_backup \
  --table-id xxxxxxxxxxxxx \
  --api-token xx

CSV Mode (outputs file for manual import)

python xb_seed_status.py \
  --id-folder ./torrents \
  --bt-backup ~/.local/share/qBittorrent/BT_backup \
  --csv-only

Upload CSV (import someone else's CSV to NocoDB)

python xb_seed_status.py \
  --upload-csv seeds.csv \
  --table-id xxxxxxxxxxxxx \
  --api-token xx

Flags

Flag	Required	Description
--id-folder	Scan modes	Folder containing {id}.torrent files (see ID Folder)
--bt-backup	Scan modes	qBittorrent's BT_backup folder
--nocodb-url	No	NocoDB base URL (default: https://xb.constantprojects.com)
--table-id	API modes	Table ID
--api-token	API modes	API token (xc-token)
--csv-only	No	Skip API, output CSV instead
--output	No	CSV output path (default: seeding_update.csv)
--upload-csv	No	Upload a CSV file to NocoDB (skip torrent scanning)
--debug	No	Print API request/response details

ID Folder

The --id-folder should point to the sanitized site export folder. You can download it from: https://tankserver.org/u/torrents%20-%20sanitized.7z

Finding NocoDB IDs

• Table ID: Click ... next to table name → Copy Table ID