dHtools es una plataforma web autohospedable y de alto rendimiento diseñada para la descarga, conversión, recorte y sincronización en la nube de contenido multimedia desde múltiples plataformas (YouTube, Spotify, Deezer, TikTok, Instagram, Twitter/X, Twitch, Facebook y más).
Está construida con una arquitectura modular de Flask Blueprints, diseñada para ejecutarse en tu propio servidor VPS o máquina local con Docker Compose, ofreciendo una interfaz moderna y reactiva con gestión multiusuario, autenticación de dos factores (2FA / TOTP), cuotas de almacenamiento en disco, servidor SMTP con recuperación de contraseñas, auditoría de sesiones en vivo, selector de canal de actualizaciones (main vs dev) y rollback automático en 1 clic.
- Motor en Cascada Automático: Combina automáticamente yt-dlp, Cobalt v11 Oficial y el motor de streaming de audio Deezer/Spotify con fallback transparente.
- Calidades de Video Ultra HD: Descarga en 4K (2160p), 2K (1440p), Full HD (1080p), 720p y 480p con selección de contenedor (
MP4/MKV) y subtítulos incrustados. - Suite de Audio Hi-Fi: Extracción directa con carátulas en alta resolución y metadatos ID3 automáticos en calidades
128 kbps,192 kbps,256 kbpsy320 kbps (CBR MP3). - Playlists & Álbumes: Detección automática y desglose de listas de reproducción con seguimiento ítem por ítem en tiempo real, priorización interactiva (⬆️/⬇️) y descarga agrupada en carpetas virtuales o archivo
.zip. - Recorte Preciso por Tiempo (Trimming): Descarga estricta por rangos temporales (
download_rangesde yt-dlp) indicando tiempos de inicio y fin (HH:MM:SS), transfiriendo únicamente los minutos deseados sin descargar archivos completos a disco. - Descargas Unificadas en Lote: Conmutador directo
[ 🔗 Enlace Único | 📋 Descarga en Lote ]integrado en Modo Fácil y Modo Avanzado. - Cola de Descargas Asíncrona: Procesamiento secuencial en segundo plano sin saturar la CPU o la memoria RAM del servidor.
- Autenticación en Dos Factores (2FA / TOTP Opcional): Estándar RFC 6238 compatible con Google Authenticator, Microsoft Authenticator, Authy, Bitwarden, etc., con QR dinámico y 8 códigos de recuperación de respaldo.
- Control de Cuotas de Disco: Asignación de cuotas máximas de almacenamiento por usuario con barra de progreso en vivo y bloqueo preventivo.
- Auditoría de Sesiones Activas: Monitor en tiempo real de sesiones conectadas (IP, dispositivo, navegador, última actividad) con revocación remota instantánea.
- Servidor SMTP & Recuperación de Contraseñas: Envío de correos seguros con tokens de un solo uso con 1 hora de validez para restablecer contraseñas.
- Protección contra Fuerza Bruta: Bloqueo temporal automático por IP tras 5 intentos fallidos con retraso progresivo (tarpit).
- Prevención de RCE e Inyecciones de Shell: Sanitización estricta de URLs (
validate_media_url) y ejecución sinshell=True. - Protección contra Path Traversal: Verificación canónica de rutas (
safe_download_path) en todos los endpoints de archivo. - Evasión de Bloqueos de YouTube: Deno integrado para resolución de desafíos JS y microservicio
potproviderpara generación continua de Proof-of-Origin Tokens.
- Sistema de Actualizaciones en 1 Clic: Comprobador de versiones contra GitHub y actualizador en caliente desde el panel web.
- Selector de Canales: Alterná entre la rama estable (
main) y la rama de desarrollo (dev) directamente desde la interfaz. - Rollback Seguro: Restauración inmediata a la versión anterior con un solo clic si algo falla.
- Gestión Multiusuario: Creación de usuarios con roles
AdminyDownloader, cambio de contraseñas, asignación de cuotas, suspensión de cuentas y purga selectiva de descargas. - 🤖 Asistente Interactivo de Telegram (Telegram Bot Hub): Solicitá descargas compartiendo enlaces directamente a tu propio bot de Telegram con selección de calidades táctil (Inline Keyboards), seguimiento dinámico de progreso en el chat, consulta de historial (
/descargas), cola (/cola) y cuota (/cuota), y entrega de archivos multimedia directos (<= 50 MB) o enlaces web seguros. - ☁️ Hub de Conectores Cloud con Presets Privados: Perfiles de almacenamiento personalizados por usuario (Nextcloud/ownCloud vía WebDAV, servidores FTP y webhooks) con aislamiento total de credenciales y herramienta de validación de conexión en 1 clic.
- Monitoreo en Tiempo Real: Métricas en vivo del uso de CPU, RAM del proyecto vs VPS total y espacio en disco con purga automática configurable.
git clone https://github.com/hernancussit/dHtools.git
cd dHtoolscp .env.example .env
nano .envDefiní tus credenciales de acceso (APP_USERNAME y APP_PASSWORD) y tu clave secreta de sesión.
docker compose up -d --buildLa aplicación estará lista en http://localhost:5000 (o http://TU_IP_VPS:5000).
Para publicar dHtools bajo tu propio dominio con HTTPS, dispones de configuraciones listas en la carpeta proxy-configs/:
Utiliza la plantilla proxy-configs/nginx-universal.conf en tu bloque de servidor:
sudo cp proxy-configs/nginx-universal.conf /etc/nginx/sites-available/dhtools.conf
# Edita tu dominio y certificados en el archivo y luego recarga:
sudo systemctl reload nginxCopia las plantillas oficiales de HestiaCP y aplícalas a tu dominio:
cp proxy-configs/hestiacp/dhtools-proxy.tpl /usr/local/hestia/data/templates/web/nginx/
cp proxy-configs/hestiacp/dhtools-proxy.stpl /usr/local/hestia/data/templates/web/nginx/
systemctl reload nginxLuego selecciona la plantilla dhtools-proxy desde la configuración web del dominio en el panel de HestiaCP.
Copia las reglas de proxy-configs/cpanel-apache.conf en el archivo .htaccess de la raíz web de tu dominio.
Añade a tu Caddyfile (configuración de proxy-configs/caddy-Caddyfile):
tu-dominio.com {
reverse_proxy 127.0.0.1:5000
}Consulta la guía detallada en proxy-configs/README.md.
dHtools cuenta con evasión antibot automática (pot-provider + Deno + Cobalt) y funciona sin cookies para el 95% de las descargas públicas. Sin embargo, si deseas descargar videos con restricción de edad (+18), contenido para miembros del canal o listas privadas, puedes suministrar un archivo cookies.txt.
Warning
- Usá SIEMPRE una cuenta secundaria (desechable): NUNCA exportes cookies de tu cuenta de Google/YouTube principal. La actividad constante de descargas desde una IP de servidor puede gatillar bloqueos temporales o suspensiones de cuenta por parte de Google.
- NO utilices esa sesión en tu navegador tras exportarla: Una vez descargado el
cookies.txt, no navegues con esa cuenta en tu navegador ni cierres sesión manualmente. El uso continuo en el navegador rota los tokens criptográficos de sesión de Google e invalida las cookies exportadas de inmediato.
- Abre una ventana de incógnito en tu navegador (Chrome, Firefox, Brave o Edge).
- Entra a YouTube e inicia sesión con tu cuenta secundaria.
- Instala una extensión de exportación de cookies en formato Netscape estándar:
- Recomendada: Get cookies.txt LOCALLY (Código abierto, segura y sin servidores externos).
- Alternativa: Cookie-Editor (Abrir en YouTube ➔ Export ➔ Export as Netscape).
- Estando en la pestaña de YouTube, abre la extensión y haz clic en "Export" o "Descargar cookies.txt".
- Guarda el archivo
.txten tu computadora.
- Desde la Web (Recomendado):
Ingresa al Panel de Administración (/admin) ➔ pestaña "⚙️ Parámetros & Cookies" ➔ haz clic en "Seleccionar nuevo cookies.txt" ➔ presiona "🚀 Validar y Guardar". El sistema validará automáticamente las cookies contra YouTube antes de guardarlas en el servidor. - Vía Terminal / Docker:
Copia el archivo generado en la raíz del proyecto comocookies.txty reinicia el contenedor (docker compose restart dhtools).
| Canal | Rama Git | Descripción |
|---|---|---|
| 🟢 Estable | main |
Versiones probadas y listas para producción en cualquier VPS. |
| 🧪 Desarrollo | dev |
Nuevas funciones experimentales y mejoras previas al lanzamiento. |
Este proyecto está bajo la Licencia MIT.