82 lines
2.1 KiB
Markdown
82 lines
2.1 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 seed_tracker.py \
|
|
--id-folder ./torrents \
|
|
--bt-backup ~/.local/share/qBittorrent/BT_backup \
|
|
--nocodb-url https://noco.example.com \
|
|
--table-id tblXXXXX \
|
|
--api-token xc-xxxx \
|
|
--id-field cXXXXX \
|
|
--seeding-field cYYYYY
|
|
```
|
|
|
|
### CSV Mode (outputs file for manual import)
|
|
|
|
```bash
|
|
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 (starts with `tbl`) |
|
|
| `--api-token` | API mode | API token (`xc-token`) |
|
|
| `--id-field` | API mode | Field ID for Id column (starts with `c`) |
|
|
| `--seeding-field` | API mode | Field ID for seeding_users column (starts with `c`) |
|
|
| `--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
|
|
- **Field IDs**: Click field header dropdown → Copy Field ID
|
|
|
|
---
|
|
|
|
# CSV Uploader
|
|
|
|
Uploads CSV files generated by others (via `--csv-only`) to NocoDB.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
python csv_uploader.py \
|
|
--csv seeds.csv \
|
|
--nocodb-url https://noco.example.com \
|
|
--table-id tblXXXXX \
|
|
--api-token xc-xxxx \
|
|
--id-field cXXXXX \
|
|
--seeding-field cYYYYY
|
|
```
|
|
|
|
## 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 |
|
|
| `--id-field` | Yes | Field ID for Id column |
|
|
| `--seeding-field` | Yes | Field ID for seeding_users column |
|