米德克斯

米德克斯

mdx 是一个简单的 CLI 应用程序，用于从 MangaDex 网站下载漫画。该程序使用 MangaDex API 来获取漫画内容。

特征 ？

• 适用于Windows、MacOS、Linux 。
• 下载多个章节。
• 以CBZ、PDF、EPUB 格式保存漫画。
• 将多个章节保存在一个文件中。
• 交互式下载模式。
• 自动生成下载文件的元数据，适用于电子阅读器。
• 搜索漫画。
• 显示有关漫画的信息。

安装

1. 从发布页面下载.tar.gz存档。
2. 取消归档文件：
   • 在 Windows 上，使用 7-Zip 等工具。
   • 在 macOS 和 Linux 上，使用终端： tar -xzf mdx-*.tar.gz
3. 运行可执行文件：
   • 在 Windows 上，打开cmd ，导航到未存档的文件夹，然后运行.mdx.exe
   • 在 macOS 和 Linux 上，打开终端，导航到未归档的文件夹，然后运行./mdx

或者，您可以通过go安装：

 go install github.com/arimatakao/mdx@latest

在 Nix、NixOS 中使用

使用 flakes 直接运行mdx ：

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

使用 flakes 创建一个临时 shell，并在 $PATH 上提供mdx ：

 nix shell github:arimatakao/mdx

安装后步骤

此步骤是可选的。如果您想从终端中的任何位置运行mdx请执行它。

视窗

将mdx.exe复制到PATH中包含的目录或将其目录添加到PATH

Linux

将mdx文件复制到/usr/bin/ ：

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

苹果系统

在您的PATH中添加mdx ：

 export PATH=$PATH:

运行source重新启动 shell 配置：

 source ~ /.zshrc

使用示例️

交互式下载方式：

mdx dl -i

交互模式演示：

注意：搜索时漫画标题应超过5个字符，以免出现错误。

下载漫画：

 # 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

检查可用更新：

mdx update

获取有关子命令和标志的帮助：

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

搜索漫画：

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

获取有关漫画的详细信息：

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

检查与 MangaDex API 的连接：

mdx ping

常问问题

哪里可以得到漫画链接？

您可以在 mangadex.org 上找到漫画链接。选择您喜欢的漫画并打开其页面。漫画的链接如下所示：

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

您可以使用此链接下载漫画的章节。

在哪里可以获得章节链接？

前往 mangadex.org，选择您喜欢的漫画，然后打开您想要的特定章节。该章节的链接如下所示：

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

您可以使用此链接下载特定章节。

我无法下载漫画 X 的 X 章。为什么？

确保您指定了正确的语言、翻译组和章节数。如果您无法下载特定章节，请尝试使用该章节的直接链接：

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

请记住： mdx 只能从 MangaDex 下载章节。

为什么下载这么慢？

我不知道。这是 MangaDex 一方或您一方的问题。

我下载了一章，但输出文件名没有卷号或章节号。为什么？

此问题源于上传者未能指定正确的卷或章节详细信息。

为什么 PDF 中的页面尺寸不同？

PDF 中每页的大小与图像的大小相对应。

出现错误“获取漫画章节时：请求失败”。我无法下载任何东西。为什么？

此问题与 MangaDex API (https://api.mangadex.org/docs/2-limitations/#general-rate-limit) 有关，mdx 每秒发送太多请求。稍后尝试下载章节。

出现错误“找不到第 xy 章，请尝试其他范围、语言、翻译组等。”

也许您没有正确指定翻译组、章节范围或语言。确保该章节可以在 MangaDex 上打开（而不是在外部资源上）。

有时由于 MangaDex 方面的一些问题而无法下载。请稍后再试。

搜索漫画时在交互模式下出错。为什么？

因为您的查询应该超过 5 个字符以避免错误。

待办事项？

功能性

• 从find子命令的列表中删除同人志，并添加doujinshi标志以在列表中显示同人志。
• 添加 cbz 下载存档的元数据。
• 添加检查更新子命令。
• 添加标志以download ：
  • merge - 将章节下载到一个文件中。
  • last - 下载最新章节。
  • this - 使用用户提供的链接下载特定章节。
  • extension - 设置输出文件的扩展名。添加文件支持格式：
    • pdf（包括元数据）。
    • epub（包括元数据）。
  • all - 下载所有章节。
  • volume - 下载指定卷的所有章节。
  • volume-range - 下载指定卷范围的所有章节。
  • volume-bundle - 将卷的所有章节下载到一个文件中。
  • oneshot - 下载漫画的所有 oneshot（如果有）。
• 为download子命令添加交互模式。
• 添加自我更新机制。
• 为find子命令添加搜索过滤器。
• 在info子命令中添加标志random以获取有关随机漫画的信息。
• 为find子命令添加交互模式。 （已添加到download子命令中）

代码

• 使用pterm输出代替fmt 。
• 重构cmd包。
• 为客户端 API 添加速率限制器。
• 创建一个 Github 操作，以便在创建新版本时自动创建.deb .rpm .pkg.tar.zst包。
• 添加mangadexapi包的测试。
• 重构internal/mdx包。
• 重构mangadexapi包。
• 重构filekit包。

执照

该项目已获得 MIT 许可 - 有关详细信息，请参阅许可证文件。

第三方库

本项目使用了以下第三方库：

• Cobra (https://github.com/spf13/cobra) - 根据 Apache License 2.0 获得许可
• Resty (https://github.com/go-resty/resty) - 获得 MIT 许可
• PTerm (https://github.com/pterm/pterm) - 获得 MIT 许可
• gopdf (https://github.com/signintech/gopdf) - 获得 MIT 许可
• go-epub (https://github.com/go-shiori/go-epub) - 获得 MIT 许可
• consolesize-go (https://github.com/nathan-fiscaletti/consolesize-go) - 获得 MIT 许可

贡献者

• 有马高
• 沃兰达克
• 尼科洛利亚希姆