Descarga archivos desde Telegram a tu servidor
100K+

Descarga archivos directamente en tu servidor a su carpeta correspondiente
/manage para ver, renombrar, eliminar, descomprimir (zip, tar y rar) y reenviar a Telegram lo que hay en el servidor/manage: entra en las carpetas, mueve archivos y carpetas entre ellas y actúa sobre un listado entero (mover, renombrar o eliminar todo)/find para buscar por nombre o por ruta en todas tus carpetasThe.Matrix.1999.1080p.mkv → The Matrix (1999) - 1080p.mkv), con plantillas, de una carpeta entera de una vez y arrastrando los subtítulos; opcionalmente automático al descargar/settings, sin tocar el docker-compose ni reiniciar/settings, con carpetas favoritas y la opción de preguntar el destino de cada descarga📦 Código fuente, incidencias y documentación completa en GitHub.
🖼️ Si deseas establecerle el icono al bot de telegram, te dejo aquí el icono en alta resolución. Solo tienes que descargarlo y mandárselo al @BotFather en la opción de BotPic.
services:
dropbot:
environment:
- TELEGRAM_TOKEN=
- TELEGRAM_ADMIN=
- TELEGRAM_API_HASH=
- TELEGRAM_API_ID=
volumes:
- /ruta/para/la/configuracion:/config
- /ruta/para/descargar/general:/downloads
image: dgongut/dropbot:latest
container_name: dropbot
restart: always
network_mode: host
docker compose up -d
Abre Telegram, envíale /start a tu bot y mándale un archivo o un enlace. Todo lo demás se ajusta desde /settings.
⚠️ Atención Mapea siempre un volumen en
/config: ahí se guardan los ajustes y la sesión de Telegram del bot, que se mueve ahí sola si estaba en/app. Sin él se pierden al recrear el contenedor, y el bot te lo recuerda al arrancar. La sesión da el mismo acceso que el token: no compartas esa carpeta, ni la uses en dos contenedores a la vez.Si revocas el token en @BotFather, basta con poner el nuevo en
TELEGRAM_TOKEN: el bot empieza una sesión nueva. Si Telegram deja de aceptar la sesión, el bot la aparta como.bady crea otra al reiniciar. Si aun así el log sigue mostrando errores de sesión, borra/config/state/dropbot-*.sessiony reinicia.Monta también
/downloads: si no es un volumen, lo descargado se queda dentro del contenedor y se pierde al recrearlo. El bot te avisa al arrancar y en/settings.
| CLAVE | OBLIGATORIO | VALOR |
|---|---|---|
| TELEGRAM_TOKEN | ✅ | Token del bot |
| TELEGRAM_ADMIN | ✅ | ChatId del administrador (se puede obtener escribiéndole /id al bot Rose por privado). Admite múltiples administradores separados por comas. Por ejemplo 12345,54431,55944. Solo vale el id de una persona: el de un grupo o un canal, o el de un admin anónimo, se ignora |
| TELEGRAM_API_HASH | ✅ | Hash de la API de Telegram (obtenido al crear tu aplicación en https://my.telegram.org) |
| TELEGRAM_API_ID | ✅ | ID de la API de Telegram (obtenido al crear tu aplicación en https://my.telegram.org) |
| TELEMETRY | ❌ | false para desactivar las estadísticas anónimas sin pasar por /settings. Lo normal es desactivarlas desde /settings; esto es para quien prefiera dejarlo fijado en el compose |
Aquí solo quedan las variables que el bot necesita antes de poder leer sus propios ajustes: cómo llegar a Telegram y quién puede hablarle. Si ponerla mal te puede dejar sin acceso al bot, va en el docker-compose, porque lo que impide que el chat funcione no se puede arreglar desde el chat.
| COMANDO | QUÉ HACE |
|---|---|
/start | El menú principal: un botón para cada cosa |
/manage | El explorador de archivos: lo que hay en el servidor con su tamaño, las carpetas se abren y cada elemento tiene sus acciones (mover, renombrar, eliminar, descomprimir o enviarlo a Telegram). /list hace lo mismo |
/find texto | Busca por nombre o por ruta en todas tus carpetas |
/settings | Los ajustes del bot |
/version | La versión instalada |
/donate · /donors | Cómo apoyar el proyecto, y quién lo ha apoyado ya |
Para descargar no hace falta ningún comando: basta con mandarle el archivo o el enlace.
Ojo con los enlaces de terceros: en los directos, el bot no sigue una redirección de una web pública a tu red local, pero yt-dlp sigue las redirecciones por su cuenta, y también los enlaces que encuentra en la página. Un enlace preparado puede hacer así que el contenedor le pida algo a un equipo de tu red (el router, un NAS). La única forma de evitarlo del todo es limitar la red del contenedor: una regla del cortafuegos o una red de Docker que no le deje salir a las direcciones privadas (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 y 169.254.0.0/16), o un proxy de salida. A cambio, el bot tampoco podrá descargar de tu red local.
/settingsSe guardan en settings.json, dentro de /config, y se aplican al momento, sin reiniciar el contenedor.
| AJUSTE | VALOR |
|---|---|
| Idioma | Español o English. Por defecto español |
| Enlaces → Descargar como | Qué hacer al recibir un enlace: preguntar si quieres vídeo o audio (por defecto), o descargar siempre como vídeo o siempre como audio |
| Enlaces → Tras descargar | Qué hacer con lo descargado desde un enlace, incluidas las playlists completas: preguntar (por defecto), enviar y guardar, enviar y eliminar del servidor, o solo guardar. No afecta a los archivos que envías al bot desde Telegram. Los de más de 2000 MB no caben en Telegram y se quedan solo en el servidor. En vídeos largos se sigue ofreciendo cancelar la conversión o enviar el original |
| Enlaces → Calidad → Vídeo | Resolución máxima: máxima disponible (por defecto), 2160p, 1440p, 1080p, 720p, 480p o 360p. Cuenta el lado corto, así que un vídeo vertical de 1080×1920 es 1080p. Si un vídeo no tiene nada por debajo del límite se baja el más pequeño que haya |
| Enlaces → Calidad → Preferir compatible con Telegram | Pide el vídeo en H.264 y el audio en AAC, que Telegram reproduce tal cual: el vídeo se envía en segundos en vez de pasar por la conversión. Como YouTube no ofrece H.264 por encima de 1080p, con esto activo un vídeo 4K se baja en 1080p. Por defecto activado |
| Enlaces → Calidad → Formato del audio | MP3 (por defecto) o M4A, que guarda el audio AAC tal como viene, sin recodificar: suena igual que el original, pesa menos y tarda menos |
| Enlaces → Calidad → Calidad del MP3 | Estándar (~128 kbps, por defecto), alta (192 kbps) o máxima (~245 kbps). Solo con MP3 |
| Enlaces → Calidad → Etiquetas y carátula | Mete en el audio el título, el artista y la miniatura del vídeo como portada. Por defecto activado |
| Enlaces → Playlists | Al recibir una playlist: preguntar si la quieres entera o solo el primer vídeo (por defecto), o hacer siempre lo mismo. Y un tope de vídeos al bajarla entera (10, 25, 50, 100 o 200; por defecto sin tope) |
| Enlaces → SponsorBlock | Quita de los vídeos de YouTube los tramos marcados por la comunidad de SponsorBlock: desactivado (por defecto), patrocinios, patrocinios y autopromoción, o todo lo que no es contenido (también intros, despedidas, avances, relleno y lo que no es música en los vídeos musicales) |
| Enlaces → Tamaño máximo | Lo que pase de este tamaño no se descarga, y el bot te lo dice: 512 MB, 1 GB, 2000 MB (lo más que se puede enviar por Telegram), 5 o 10 GB, o sin límite (por defecto). En una playlist se salta ese vídeo y se sigue con el resto |
| Descargas simultáneas | Archivos que se transfieren a la vez. Por defecto 2 |
| Conexiones por archivo | Conexiones paralelas por archivo para acelerar la transferencia (estilo FastTelethon). 1 = método estándar de Telethon. Recomendado 4-8. Por defecto 8 |
| Conversión de vídeo → Encoder | CPU (libx264, por defecto), VAAPI (Intel/AMD, recomendado), NVENC (NVIDIA) o QSV (Intel Quick Sync, experimental: necesita el runtime de Intel y no viene en la imagen). Si el encoder hardware falla, se reintenta automáticamente con libx264. Ver desplegable de aceleración por hardware |
| Conversión de vídeo → Calidad | Entre las que ofrece el menú (18-35), o la predeterminada de cada encoder (por defecto). Valores más altos reducen calidad y tamaño. 23 es un buen valor inicial |
| Tras descomprimir | Qué hacer con el archivo comprimido después de descomprimirlo desde /manage: preguntar (por defecto), eliminarlo (con todas sus partes, si es un RAR multiparte) o conservarlo |
| Carpetas | Dónde va cada tipo de archivo: toca un tipo para elegir su carpeta, o déjalo en la que le toca por los volúmenes. Ver desplegable de carpetas |
| Carpetas → Favoritas | Carpetas que salen las primeras al mover un archivo o elegir destino |
| Carpetas → Preguntar la carpeta | Al terminar cada descarga, pregunta en qué carpeta guardarla. Por defecto desactivado |
| Carpetas → Avisar si puede no caber | Avisa cuando el archivo que llega ocupa más que el espacio libre. Por defecto activado |
| Renombrado | Renombrar al descargar (por defecto desactivado), sustituir sin preguntar si el nombre ya existe y las plantillas. Ver desplegable de renombrado |
| Series a su carpeta | Proponer la carpeta de la serie (por defecto activado) y mandar los episodios directos a ella (por defecto desactivado). Ver desplegable de la carpeta de la serie |
| Estadísticas anónimas | Una vez al día envía cifras anónimas de uso. Por defecto activado. Ver desplegable de estadísticas |
Todo va a /downloads salvo que montes la carpeta de un tipo: entonces va ahí. No hay que activar nada más. Y si prefieres otra, la eliges desde /settings (más abajo).
| CARPETA | QUÉ VA AHÍ |
|---|---|
/video | Vídeos |
/audio | Audios |
/photo | Imágenes |
/torrent | Archivos .torrent |
/ebook | Libros electrónicos |
/url_video | Vídeos descargados desde enlaces. Si no la montas, van donde el resto de vídeos |
/url_audio | Audios descargados desde enlaces. Si no la montas, van donde el resto de audios |
volumes:
- /ruta/para/la/configuracion:/config
- /ruta/para/descargar/general:/downloads
- /ruta/para/descargar/video:/video
- /ruta/para/descargar/audio:/audio
En /settings → 📁 Carpetas ves a dónde está yendo cada tipo y puedes cambiarlo: toca un tipo y elige su carpeta navegando con botones, creando una nueva o escribiendo la ruta. Vale cualquier carpeta que esté dentro de un volumen montado (una subcarpeta de /downloads, otro volumen como /media/pelis...); fuera de uno no, porque se perdería al actualizar el contenedor. Se aplica al momento, y ↩️ lo devuelve a la de por defecto. Si un día quitas del compose el volumen de una carpeta elegida, el bot lo avisa en el log y vuelve a usar la de por defecto.
En /manage cada carpeta se abre como en un explorador: una que está dentro de otra (por ejemplo /downloads/Vídeos) se ve como carpeta dentro de ella, no mezclada con el resto.
/manage es un explorador de lo que hay en tus carpetas:
/find texto. Busca por nombre en todas tus carpetas, sin importar mayúsculas ni tildes y con las palabras en cualquier orden (/find casa papel encuentra La.Casa.de.Papel). Entre comillas, la frase exacta; lo que empieza por / se busca en la ruta (/find /video 1080p).El bot solo guarda y mueve dentro de volúmenes montados: una carpeta que no esté en uno se perdería al actualizar el contenedor, así que ni se ofrece ni se acepta escrita a mano. Para usar otra carpeta (por ejemplo /media/series), móntala en el docker-compose y añádela a favoritas en /settings → 📁 Carpetas: saldrá en el selector y se podrá abrir desde /manage.
Al pulsar ✏️ Renombrar, el bot sugiere un nombre limpio:
The.Matrix.1999.1080p.BluRay.x264.mkv → The Matrix (1999) - 1080p.mkvOperaciones Especiales Lioness [HDTV 1080p][Cap.103] → 1x03 - Operaciones Especiales Lioness - 1080p (entiende Cap.103, S01E03, T01E03, 3x05, Temporada 1 Capitulo 3, rangos y packs de temporada)En una carpeta, 🪄 Renombrar todo lo hace de una vez:
Mad.Men.2007.COMPLETE.1080p.NF.WEB-DL/ Mad Men (2007) - 1080p/
├── Mad.Men.2007.S01.NF.WEB-DL.1080P.AV1-Txv2/ → ├── T1 - Mad Men - 1080p/
│ └── Mad.Men.S01E01.1080p.mkv │ └── 1x01 - Mad Men - 1080p.mkv
└── Extras/ └── Extras/
Los archivos toman de su carpeta lo que no llevan encima (título, año y temporada, nunca el episodio), así que 01.mkv dentro de Show.Name.S02.1080p pasa a ser 2x01 - Show Name - 1080p.mkv. Las carpetas que no identifican nada (Extras, Subs) y las muestras (sample.mkv) se quedan como están.
En /settings → ✏️ Renombrado:
{titulo}, {año}, {temporada}, {episodio.2} (con ceros), {resolucion}, {titulo_episodio}... [ ... ] es un bloque opcional, que desaparece si falta algún campo de dentro. La pantalla enseña un ejemplo con cada plantilla.Es el mismo motor de Torrent-Controller-Bot, donde está la referencia completa de las plantillas.
Cuando llega un episodio o un pack de temporada, el bot busca en tus carpetas otros de la misma serie. Compara el título sin tener en cuenta mayúsculas, tildes ni puntuación (Chicago.Fire.S14E04, 14x03 - Chicago Fire.mkv y chicago fire s14e02 son la misma), y si los dos nombres llevan año, tiene que coincidir. Nunca hace coincidencias parciales: Chicago Fire y Chicago Med son series distintas.
/manage esa carpeta sale la primera, marcada con ✨.Si guardas las temporadas en subcarpetas (Mad Men/Season 01), un episodio de la siguiente se propone en Mad Men/Season 02, aunque esa carpeta aún no exista. Las carpetas de descarga, que es donde cae todo antes de ordenarlo, nunca se proponen salvo que lleven el nombre de la serie. Se busca hasta cuatro niveles por debajo de las carpetas de descarga y de tus favoritas.
Solo se convierte lo que Telegram no puede reproducir. Un MP4 con vídeo H.264 (8 bits) o HEVC (8/10 bits, lo que graban los móviles) y audio AAC/MP3 se envía tal cual; si el vídeo ya vale pero el contenedor (MKV, MOV...), el audio (Opus...) o la etiqueta HEVC (hev1 en vez de hvc1, que necesitan los dispositivos Apple) no, se copia la pista de vídeo sin recodificar y la operación tarda segundos. Solo VP9, AV1 y similares pasan por la conversión completa, que por CPU da siempre H.264 4:2:0 de 8 bits, lo único que Telegram reproduce en todos sus clientes.
Lo que descargas de enlaces se pide por defecto en H.264 y AAC (ver Preferir compatible con Telegram en los ajustes), así que normalmente ni siquiera hace falta convertirlo.
La conversión completa va por CPU salvo que elijas otro encoder en /settings → 🎞️ Conversión de vídeo. Para usar la GPU, dale al contenedor acceso a ella:
# Para VAAPI/QSV, da acceso al dispositivo `/dev/dri`:
devices:
- /dev/dri:/dev/dri
# Para NVENC necesitas NVIDIA Container Toolkit y dar acceso a la GPU:
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: all
capabilities: [gpu]
Puedes comprobar qué encoder se está usando en los logs ([CONVERSION] Encoder mode: ...). Si el encoder por hardware falla con un vídeo, se reintenta automáticamente por CPU.
Para sitios que requieren una sesión autenticada, crea cookies/cookies.txt y
monta la carpeta en /app/cookies. Puede ser de solo lectura (:ro): yt-dlp
trabaja con una copia. Si se puede escribir, las cookies que renueve yt-dlp se
guardan en el archivo, salvo que lo hayas cambiado mientras tanto: un
cookies.txt recién exportado no se pisa. Si el archivo no existe, DropBot
continúa usando yt-dlp sin cookies.
volumes:
- /ruta/para/cookies:/app/cookies
TELEGRAM_ADMIN solo admite ids de persona. Si tenías el id de un grupo o de un canal (empiezan por -) para manejar el bot como admin anónimo, ahora se ignora: el bot arranca con los demás ids y te lo dice en el mensaje de arranque. Si era el único, el bot no arranca y lo explica en el log. Pon tu propio id, que te da el bot Rose si le escribes /id por privado (en un grupo te da el del grupo).🔄 ¿Vienes de la 3.x? Cómo migrar, en GitHub.
Desde la 4.0.0 el bot envía una vez al día unas cifras anónimas para saber cuánta gente lo usa y qué funciones se usan más. Así sé dónde poner el esfuerzo. Las estadísticas son públicas: stats.dgongut.com/dropbot.
Qué se envía: qué ajustes están activados, qué tipos de archivo tienen carpeta propia (sí o no, nunca la ruta), si hay cookies o GPU disponibles, la versión del bot, la arquitectura, y cuántas veces al día se ha usado cada comando, cada botón y cada tipo de descarga y de conversión. La lista completa, campo a campo, está en la página de privacidad. El servidor descarta cualquier dato que no esté en ella.
Qué no se envía nunca: nombres de archivos, enlaces, rutas, IDs de Telegram ni nada de lo que escribes. Tu IP no se guarda.
Cómo se desactiva: desde /settings → Estadísticas anónimas, o con TELEMETRY=false. Al desactivarlas se borra también el identificador de la instalación. Con 👀 Ver qué se envía ves exactamente lo que llevaría el próximo envío.
Están activadas por defecto. Nada se envía hasta que el bot lleva al menos 10 minutos en marcha. Tampoco se envía si /config no está en un volumen, porque sin él cada vez que se recreara el contenedor contaría como una instalación nueva.
Content type
Image
Digest
sha256:f661a8629…
Size
362.3 MB
Last updated
6 days ago
docker pull dgongut/dropbot