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

1.7 KiB Raw Permalink Blame History