mdx

mdx

mdx es una aplicación CLI sencilla para descargar manga desde el sitio web MangaDex. El programa utiliza MangaDex API para buscar contenido manga.

Características ?

• Funciona en Windows, MacOS, Linux .
• Descarga varios capítulos .
• Guarda manga en formatos CBZ, PDF, EPUB .
• Guarda varios capítulos en un archivo .
• Modo de descarga interactiva .
• Genera automáticamente metadatos para archivos descargados, adaptados para lectores electrónicos .
• Busca manga.
• Muestra información sobre manga.

Instalación

1. Descargue el archivo .tar.gz desde la página de lanzamientos.
2. Desarchivar el archivo:
   • En Windows, utilice herramientas como 7-Zip.
   • En macOS y Linux, use la terminal: tar -xzf mdx-*.tar.gz
3. Ejecute el ejecutable:
   • En Windows, abra cmd , navegue hasta la carpeta no archivada y ejecute .mdx.exe
   • En macOS y Linux, abra la terminal, navegue hasta la carpeta no archivada y ejecute ./mdx

Alternativamente, puedes instalar a través de go :

 go install github.com/arimatakao/mdx@latest

Usando en Nix, NixOS

Usando flakes para ejecutar mdx directamente:

 nix run github:arimatakao/mdx -- download --help

Usando flakes para crear un shell temporal con mdx disponible en $PATH:

 nix shell github:arimatakao/mdx

Pasos posteriores a la instalación

Este paso es opcional. Realícelo si desea ejecutar mdx desde cualquier lugar de su terminal.

ventanas

Copie mdx.exe a un directorio incluido en su PATH o agregue su directorio a la PATH

linux

Copie el archivo mdx a /usr/bin/ :

sudo cp mdx /usr/bin/
# or
sudo cp mdx /usr/local/bin/

Mac OS

Agregue mdx en su PATH :

 export PATH=$PATH:

Ejecute source para reiniciar la configuración del shell:

 source ~ /.zshrc

Ejemplos de uso️

Modo de descarga interactiva:

mdx dl -i

Demostración del modo interactivo:

Nota: El título de su manga debe tener más de 5 caracteres al realizar la búsqueda para evitar errores.

Descargar manga:

 # get help
mdx download --help

# by default 1 chapter is being downloaded
mdx download -u https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370/this-gorilla-will-die-in-1-day
# or
mdx dl -u https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370/this-gorilla-will-die-in-1-day
# or
mdx dl https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or
mdx dl mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download pdf format instead of cbz
mdx dl -e pdf mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or epub format
mdx dl -e epub mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download all chapters
# i don't recommend using this flag - https://github.com/arimatakao/mdx?tab=readme-ov-file#getting-error-while-getting-manga-chapters-request-is-failed-i-cant-download-anything-why
mdx dl -a mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download a specific chapter
mdx dl -c 3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or set direct link to the chapter
mdx dl --this mangadex.org/chapter/7c5d2aea-ea55-47d9-8c65-a33c9e92df70
# or
mdx dl https://mangadex.org/chapter/7c5d2aea-ea55-47d9-8c65-a33c9e92df70

# download a range of chapters
mdx dl -c 1-3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download a range of chapters and merge them in one file
mdx dl -m -c 1-3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download last chapter
mdx dl --last mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify language, default is english (to get the available languages, execute the info subcommand)
mdx dl -l it mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify the output directory
mdx dl -o your/dir mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify translation
mdx dl -t " Black Cat " mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download compressed version (lower image quality and file size)
mdx dl -j mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

Consulta las actualizaciones disponibles:

mdx update

Obtenga ayuda sobre subcomandos e indicadores:

mdx
mdx -h
# ping subcommand is example
mdx ping
mdx ping -h

Buscar manga:

mdx find -t " Manga Title "
mdx search -t " Manga Title "
mdx f -t " Manga Title "

Obtenga información detallada sobre el manga:

mdx info -u https://mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk
# or
mdx info mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

Verifique la conexión a la API MangaDex:

mdx ping

Preguntas frecuentes

¿Dónde puedo conseguir el enlace del manga?

Puedes encontrar el enlace del manga en mangadex.org. Elige el manga que te guste y abre su página. El enlace al manga se ve así:

 https://mangadex.org/title/abc-123-abc/some-title

Puedes utilizar este enlace para descargar capítulos del manga.

¿Dónde puedo conseguir el enlace del capítulo?

Vaya a mangadex.org, elija el manga que le guste y abra el capítulo específico que desee. El enlace al capítulo se ve así:

 https://mangadex.org/chapter/abc-123-abc

Puede utilizar este enlace para descargar el capítulo específico.

No puedo descargar el capítulo X del manga X. ¿Por qué?

Asegúrese de haber especificado el idioma, el grupo de traducción y el número de capítulos correctos. Si no puede descargar un capítulo específico, intente utilizar el enlace directo al capítulo:

 mdx dl https://mangadex.org/chapter/abc-123-abc

Recuerde: mdx sólo puede descargar capítulos de MangaDex.

¿Por qué la descarga es tan lenta?

No sé. Es un problema del lado de MangaDex o del tuyo.

Descargué un capítulo pero el nombre del archivo de salida no tiene el número de volumen ni el número de capítulo. ¿Por qué?

Este problema se debe a que quien subió el archivo no especificó el volumen o los detalles del capítulo correctos.

¿Por qué las páginas del PDF tienen diferentes tamaños?

El tamaño de cada página del PDF corresponde al tamaño de la imagen.

Aparece el error "Al obtener capítulos de manga: la solicitud falló". No puedo descargar nada. ¿Por qué?

Este problema está relacionado con la API MangaDex (https://api.mangadex.org/docs/2-limitations/#general-rate-limit), mdx envía demasiadas solicitudes por segundo. Intente descargar capítulos más tarde.

Aparece el error "Capítulos xy no encontrados, pruebe con otro rango, idioma, grupo de traducción, etc."

Quizás no especificaste correctamente el grupo de traducción, el rango de capítulos o el idioma. Asegúrese de que el capítulo se pueda abrir en MangaDex (no en un recurso externo).

A veces no se descarga debido a algunos problemas en el lado de MangaDex. Inténtalo de nuevo más tarde.

Aparece un error en el modo interactivo al buscar manga. ¿Por qué?

Porque tu consulta debe tener más de 5 caracteres para evitar errores.

HACER ?

Funcionalidad

• Elimine Doujinshi de la lista en el subcomando find y agregue la bandera doujinshi para mostrar Doujinshi en la lista.
• Agregue metadatos para el archivo descargado de cbz.
• Agregue el subcomando verificar actualización.
• Agregar bandera para download :
  • merge : descargar capítulos en un solo archivo.
  • last : descargue el último capítulo.
  • this : descargue un capítulo específico utilizando un enlace proporcionado por el usuario.
  • extension : establece la extensión del archivo de salida. Agregue formatos de soporte de archivos:
    • pdf (incluir metadatos).
    • epub (incluye metadatos).
  • all : descarga todos los capítulos.
  • volume : descargue todos los capítulos del volumen especificado.
  • volume-range : descargue todos los capítulos del rango de volumen especificado.
  • volume-bundle : descargue todos los capítulos del volumen en un solo archivo.
  • oneshot : descarga todos los oneshots del manga (si están disponibles).
• Agregue modo interactivo para download el subcomando.
• Agregue un mecanismo de actualización automática.
• Agregue un filtro de búsqueda para el subcomando find .
• Agregue una bandera random en el subcomando de info para obtener información sobre manga aleatorio.
• Agregue modo interactivo para el subcomando find . (ya agregado al subcomando download )

Código

• Utilice la salida pterm en lugar de fmt .
• Refactorizar el paquete cmd .
• Agregue un limitador de velocidad para la API del cliente.
• Cree una acción de Github para automatizar la creación de paquetes .deb .rpm .pkg.tar.zst cuando se crea una nueva versión.
• Agregue pruebas para el paquete mangadexapi .
• Refactorizar el paquete internal/mdx .
• Refactorizar el paquete mangadexapi .
• Refactorizar el paquete filekit .

Licencia

Este proyecto tiene licencia del MIT; consulte el archivo de LICENCIA para obtener más detalles.

Bibliotecas de terceros

Este proyecto utiliza las siguientes bibliotecas de terceros:

• Cobra (https://github.com/spf13/cobra): con licencia Apache 2.0
• Resty (https://github.com/go-resty/resty): con licencia del MIT
• PTerm (https://github.com/pterm/pterm): con licencia del MIT
• gopdf (https://github.com/signintech/gopdf): con licencia del MIT
• go-epub (https://github.com/go-shiori/go-epub): con licencia del MIT
• consolesize-go (https://github.com/nathan-fiscaletti/consolesize-go): con licencia del MIT

Colaboradores

• arimatakao
• wolandark
• nikololiahim