Sign inSign up

dgongut/dropbot

By dgongut

•Updated 6 days ago

Descarga archivos desde Telegram a tu servidor

Image
1

100K+

dgongut/dropbot repository overview

⁠dropbot

Docker Pulls Docker Stars Docker Image Size Github stars Github forks Github last-commit Github license

⁠ ReadMe en Español | ReadMe in English⁠

alt text

Descarga archivos directamente en tu servidor a su carpeta correspondiente

  • ✅ Mándale un archivo y lo guarda en su carpeta: vídeo, audio (también notas de voz), fotos, torrents, libros o el resto
  • ✅ Mándale un enlace de YouTube, Instagram, TikTok, Twitter y 1800+ sitios más y descarga el vídeo o el audio
  • ✅ Los enlaces directos a un archivo (un PDF, un ZIP...) se descargan tal cual
  • ✅ Elige la calidad de lo que bajas de un enlace: resolución máxima, MP3 o M4A sin recodificar, y título, artista y carátula dentro del audio
  • ✅ Quita patrocinios y autopromoción de los vídeos de YouTube con SponsorBlock
  • ✅ Playlists enteras o solo el primer vídeo, con un tope de vídeos y un tamaño máximo por descarga
  • ✅ Te devuelve a Telegram lo descargado, convertido solo si Telegram no puede reproducirlo, y con aceleración por hardware (VAAPI, NVENC, QSV)
  • ✅ Transferencias rápidas con varias conexiones por archivo
  • ✅ /manage para ver, renombrar, eliminar, descomprimir (zip, tar y rar) y reenviar a Telegram lo que hay en el servidor
  • ✅ Explorador de archivos en /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 carpetas
  • ✅ Renombrado inteligente de películas y series (The.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
  • ✅ Carpeta de la serie: un episodio nuevo se ofrece (o va directo, si lo activas) a la carpeta donde ya tienes los anteriores
  • ✅ Sustituir una versión anterior: si el nombre que le toca a una descarga ya lo tiene otro archivo, te ofrece quedarte con el nuevo
  • ✅ Todo se ajusta desde el propio bot con /settings, sin tocar el docker-compose ni reiniciar
  • ✅ Cada tipo de archivo a su carpeta con solo montarla, o a la que elijas desde /settings, con carpetas favoritas y la opción de preguntar el destino de cada descarga
  • ✅ Español e inglés

📦 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.

⁠Puesta en marcha

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 .bad y crea otra al reiniciar. Si aun así el log sigue mostrando errores de sesión, borra /config/state/dropbot-*.session y 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.

CLAVEOBLIGATORIOVALOR
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.

⁠Comandos

COMANDOQUÉ HACE
/startEl menú principal: un botón para cada cosa
/manageEl 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 textoBusca por nombre o por ruta en todas tus carpetas
/settingsLos ajustes del bot
/versionLa versión instalada
/donate · /donorsCó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.

⁠Ajustes y más

⚙️ Ajustes de /settings

Se guardan en settings.json, dentro de /config, y se aplican al momento, sin reiniciar el contenedor.

AJUSTEVALOR
IdiomaEspañol o English. Por defecto español
Enlaces → Descargar comoQué 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 descargarQué 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ídeoResolució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 TelegramPide 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 audioMP3 (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 MP3Estándar (~128 kbps, por defecto), alta (192 kbps) o máxima (~245 kbps). Solo con MP3
Enlaces → Calidad → Etiquetas y carátulaMete en el audio el título, el artista y la miniatura del vídeo como portada. Por defecto activado
Enlaces → PlaylistsAl 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 → SponsorBlockQuita 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áximoLo 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áneasArchivos que se transfieren a la vez. Por defecto 2
Conexiones por archivoConexiones 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 → EncoderCPU (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 → CalidadEntre 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 descomprimirQué 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
CarpetasDó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 → FavoritasCarpetas que salen las primeras al mover un archivo o elegir destino
Carpetas → Preguntar la carpetaAl terminar cada descarga, pregunta en qué carpeta guardarla. Por defecto desactivado
Carpetas → Avisar si puede no caberAvisa cuando el archivo que llega ocupa más que el espacio libre. Por defecto activado
RenombradoRenombrar al descargar (por defecto desactivado), sustituir sin preguntar si el nombre ya existe y las plantillas. Ver desplegable de renombrado
Series a su carpetaProponer 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ónimasUna vez al día envía cifras anónimas de uso. Por defecto activado. Ver desplegable de estadísticas
📁 Cada tipo de archivo en su carpeta

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).

CARPETAQUÉ VA AHÍ
/videoVídeos
/audioAudios
/photoImágenes
/torrentArchivos .torrent
/ebookLibros electrónicos
/url_videoVídeos descargados desde enlaces. Si no la montas, van donde el resto de vídeos
/url_audioAudios 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.

🗂️ Gestionar lo que hay en el servidor: mover, renombrar, buscar

/manage es un explorador de lo que hay en tus carpetas:

  • Carpetas. Tocar una carpeta la abre; ⬆️ Subir vuelve a la de encima y 🔧 Esta carpeta abre sus acciones. Los listados largos van por páginas.
  • 📦 Mover. Un archivo o una carpeta entera a otra carpeta. El selector ofrece primero tus favoritas (⭐) y las carpetas de descarga (📂); dentro de cada una puedes bajar a sus subcarpetas, crear una nueva o escribir la ruta. Nunca pisa nada: si en el destino ya hay algo con ese nombre, no se mueve y te lo dice. Entre discos distintos copia a un oculto y solo al terminar borra el original.
  • ✏️ Renombrar. A mano, o con un toque si el bot reconoce una película o un episodio (ver Renombrado inteligente). Los subtítulos de un vídeo se renombran con él.
  • 🪄 Renombrar todo. En una carpeta: ella misma, sus subcarpetas de temporada y los episodios, con vista previa antes de confirmar.
  • ☑️ Seleccionar todo. Sobre todo un listado (una carpeta o una búsqueda): moverlos, renombrarlos o eliminarlos de una vez. Se actúa sobre lo que se enseñó al confirmar, no sobre lo que llegue después.
  • /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.

✏️ Renombrado inteligente

Al pulsar ✏️ Renombrar, el bot sugiere un nombre limpio:

  • Películas: The.Matrix.1999.1080p.BluRay.x264.mkv → The Matrix (1999) - 1080p.mkv
  • Series: Operaciones 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:

  • Renombrar al descargar le pone la sugerencia, sin preguntar, a cada vídeo que llega.
  • Sustituir sin preguntar si el nombre ya existe: si descargas una copia mejor de algo que ya tenías, el nombre que le toca lo tiene el archivo antiguo. Desactivado (por defecto), el bot te ofrece 🔁 Sustituir el anterior; activado, elimina el antiguo y se queda con el nuevo. Nunca sustituye una carpeta.
  • Plantillas de películas, episodios y packs de temporada, con campos como {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.

🧭 Carpeta de la serie

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.

  • Proponer (por defecto): al terminar la descarga te ofrece moverlo con los demás, y al mover desde /manage esa carpeta sale la primera, marcada con ✨.
  • Directo (desactivado por defecto): lo manda sin preguntar cuando no hay ninguna duda (una única carpeta con el nombre de la serie, o en la que solo hay episodios suyos), y el aviso lleva un botón ↩️ Deshacer. Con dudas, lo propone en vez de decidir por ti.

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.

🎞️ Conversión de vídeo y aceleración por hardware

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.

🍪 Cookies opcionales para yt-dlp

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
🔄 ¿Vienes de la 4.0.0?
  • 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⁠.

📊 Estadísticas anónimas

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.

Tag summary

Content type

Image

Digest

sha256:f661a8629…

Size

362.3 MB

Last updated

6 days ago

docker pull dgongut/dropbot