TurboDLReferencia del perfil
Todos los campos de un perfil JSON, sus valores por defecto y sus límites.
Un perfil es un archivo JSON. Todos los campos son opcionales: un campo ausente toma su valor por defecto. Un campo desconocido se rechaza (se detectan las erratas).
El archivo profile.schema.json incluido con TurboDL describe este formato: refiérelo con "$schema" para tener autocompletado en VS Code.
Campos principales
| Campo | Por defecto | Descripción |
|---|---|---|
download_dir | ~/Downloads | Carpeta de destino; ~ y ${VAR} se expanden |
sort_by_category | true | Subcarpeta por categoría |
threads | 8 | Conexiones paralelas, de 1 a 32 |
max_retries | 5 | Reintentos por segmento (y para la primera petición) |
timeout_secs | 30 | Tiempo de espera de conexión y lectura, > 0 |
user_agent | Mozilla/5.0 (compatible; TurboDL) | User-Agent |
on_conflict | rename | rename, overwrite o skip |
verbosity | normal | minimal, normal o full (CLI) |
categories | ver Categorías | Extensiones y subcarpeta de cada categoría |
Sección request
| Campo | Por defecto | Descripción |
|---|---|---|
method | GET | Método HTTP |
headers | {} | Cabeceras; los valores aceptan ${VAR} |
body | null | {"text": "…"}, {"file": "ruta"} o {"json": {…}} |
cookies_file | null | Archivo cookies.txt (Netscape) |
auth.user | null | Usuario Basic |
auth.password_env | null | Variable de entorno con la contraseña |
proxy | null | http://, https:// o socks5:// |
max_redirs | 10 | Redirecciones máximas |
insecure | false | Ignora los errores de certificado (peligroso) |
Atención
Nunca pongas una contraseña o un token en claro en un perfil: usa ${VARIABLE} en las cabeceras y auth.password_env.
Validación
Un perfil no válido se rechaza con la ruta exacta del campo erróneo, por ejemplo request.max_redirs: invalid type. La CLI sale entonces con el código 2.