xb-seed-catalog/README.md

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+
• No external dependencies

Usage

API Mode (updates NocoDB directly)

python xb_seed_status.py \
  --id-folder ./torrents \
  --bt-backup ~/.local/share/qBittorrent/BT_backup \
  --nocodb-url https://noco.example.com \
  --table-id xxxxxxxxxxxxx \
  --api-token xc-xxxx

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 \
  --nocodb-url https://noco.example.com \
  --table-id xxxxxxxxxxxxx \
  --api-token xc-xxxx

Flags

Flag	Required	Description
--id-folder	Scan modes	Folder containing {id}.torrent files
--bt-backup	Scan modes	qBittorrent's BT_backup folder
--nocodb-url	API modes	NocoDB base URL
--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

Finding NocoDB IDs

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