Files
xb-seed-catalog/README.md
constantprojects e7dd24de73 Update README and csv_uploader to match hardcoded field names
Remove --id-field and --seeding-field args from csv_uploader, hardcode
field names as class constants, and fix the same PATCH/GET bugs. Update
README examples to reflect simplified CLI args.
2026-02-17 15:25:07 -07:00

1.7 KiB

Seed Tracker

Matches {id}.torrent files against your qBittorrent session and updates NocoDB with your username.

Requirements

  • Python 3.10+
  • No external dependencies

Usage

API Mode (updates NocoDB directly)

python seed_tracker.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 seed_tracker.py \
  --id-folder ./torrents \
  --bt-backup ~/.local/share/qBittorrent/BT_backup \
  --csv-only

Flags

Flag Required Description
--id-folder Yes Folder containing {id}.torrent files
--bt-backup Yes qBittorrent's BT_backup folder
--nocodb-url API mode NocoDB base URL
--table-id API mode Table ID
--api-token API mode API token (xc-token)
--csv-only No Skip API, output CSV instead
--output No CSV output path (default: seeding_update.csv)
--debug No Print API request/response details

Finding NocoDB IDs

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

CSV Uploader

Uploads CSV files generated by others (via --csv-only) to NocoDB.

Usage

python csv_uploader.py \
  --csv seeds.csv \
  --nocodb-url https://noco.example.com \
  --table-id xxxxxxxxxxxxx \
  --api-token xc-xxxx

Flags

Flag Required Description
--csv Yes CSV file to upload
--nocodb-url Yes NocoDB base URL
--table-id Yes Table ID
--api-token Yes API token