59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# 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)
|
|
|
|
```bash
|
|
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)
|
|
|
|
```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 \
|
|
--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
|