# 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)

```bash
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)

```bash
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)

```bash
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](#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