61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# 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
|