TurboDLRéférence du profil
Tous les champs d'un profil JSON, leurs valeurs par défaut et leurs limites.
Un profil est un fichier JSON. Tous les champs sont facultatifs : un champ absent prend sa valeur par défaut. Un champ inconnu est refusé (faute de frappe détectée).
Le fichier profile.schema.json livré avec TurboDL décrit ce format : référencez-le avec "$schema" pour avoir l'autocomplétion dans VS Code.
Champs principaux
| Champ | Défaut | Description |
|---|---|---|
download_dir | ~/Downloads | Dossier de destination ; ~ et ${VAR} sont développés |
sort_by_category | true | Sous-dossier par catégorie |
threads | 8 | Connexions parallèles, 1 à 32 |
max_retries | 5 | Tentatives par segment (et pour la première requête) |
timeout_secs | 30 | Délai de connexion et de lecture, > 0 |
user_agent | Mozilla/5.0 (compatible; TurboDL) | User-Agent |
on_conflict | rename | rename, overwrite ou skip |
verbosity | normal | minimal, normal ou full (CLI) |
categories | voir Catégories | Extensions et sous-dossier de chaque catégorie |
Section request
| Champ | Défaut | Description |
|---|---|---|
method | GET | Méthode HTTP |
headers | {} | En-têtes ; les valeurs acceptent ${VAR} |
body | null | {"text": "…"}, {"file": "chemin"} ou {"json": {…}} |
cookies_file | null | Fichier cookies.txt (Netscape) |
auth.user | null | Utilisateur Basic |
auth.password_env | null | Variable d'environnement du mot de passe |
proxy | null | http://, https:// ou socks5:// |
max_redirs | 10 | Redirections maximales |
insecure | false | Ignore les erreurs de certificat (dangereux) |
Attention
Ne mettez jamais un mot de passe ou un jeton en clair dans un profil : utilisez ${VARIABLE} dans les en-têtes et auth.password_env.
Validation
Un profil invalide est refusé avec le chemin exact du champ fautif, par exemple request.max_redirs: invalid type. La CLI quitte alors avec le code 2.