mdx

mdx

mdx は、mangaDex Web サイトからマンガをダウンロードするためのシンプルな CLI アプリケーションです。このプログラムは、mangaDex API を使用してマンガ コンテンツを取得します。

特徴 ？

• Windows、MacOS、Linuxで動作します。
• 複数の章をダウンロードします。
• マンガをCBZ、PDF、EPUB形式で保存します。
• 複数のチャプターを1 つのファイルに保存します。
• インタラクティブダウンロードモード。
• 電子書籍リーダーに適した、ダウンロードされたファイルのメタデータを自動的に生成します。
• マンガを検索します。
• マンガに関する情報を表示します。

インストール

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での使用

フレークを使用してmdx直接実行します。

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

フレークを使用して、$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/

MacOS

PATHにmdx追加します。

 export PATH=$PATH:

source実行してシェル構成を再起動します。

 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 が 1 秒あたりに送信するリクエストが多すぎます。後で章をダウンロードしてみてください。

「章 xy が見つかりません。別の範囲、言語、翻訳グループなどを試してください。」というエラーが発生します。

翻訳グループ、章範囲、または言語を正しく指定しなかった可能性があります。その章が (外部リソースではなく) マンガデックス上で開くことができることを確認してください。

MangaDex側の問題によりダウンロードできない場合があります。後でもう一度試してください。

インタラクティブモードでマンガを検索するとエラーが発生します。なぜ？

エラーを避けるために、クエリは 5 文字以上にする必要があるためです。

藤堂 ?

機能性

• findサブコマンドのリストから同人誌を削除し、リストに同人誌を表示するためのdoujinshiフラグを追加します。
• cbz ダウンロードされたアーカイブのメタデータを追加します。
• check update サブコマンドを追加します。
• downloadするフラグを追加します:
  • merge - チャプターを 1 つのファイルにダウンロードします。
  • last - 最新の章をダウンロードします。
  • this - ユーザーが提供したリンクを使用して特定の章をダウンロードします。
  • extension - 出力ファイルの拡張子を設定します。ファイル サポート形式を追加します。
    • pdf (メタデータを含む)。
    • epub (メタデータを含む)。
  • all - すべての章をダウンロードします。
  • volume - 指定したボリュームのすべての章をダウンロードします。
  • volume-range - 指定されたボリューム範囲のすべてのチャプターをダウンロードします。
  • volume-bundle - ボリュームのすべての章を 1 つのファイルにダウンロードします。
  • oneshot - マンガのすべての oneshot をダウンロードします (利用可能な場合)。
• downloadサブコマンドに対話モードを追加します。
• 自己更新メカニズムを追加します。
• findサブコマンドに検索フィルターを追加します。
• infoサブコマンドに flag randomを追加して、ランダムなマンガに関する情報を取得します。
• findサブコマンドに対話モードを追加しました。 ( downloadサブコマンドにすでに追加されています)

コード

• fmtの代わりにpterm出力を使用してください。
• cmdパッケージをリファクタリングします。
• クライアント API にレート リミッターを追加します。
• 新しいリリースの作成時に.deb .rpm .pkg.tar.zstパッケージの作成を自動化する Github アクションを作成します。
• mangadexapiパッケージのテストを追加します。
• internal/mdxパッケージをリファクタリングします。
• mangadexapiパッケージをリファクタリングします。
• filekitパッケージをリファクタリングします。

ライセンス

このプロジェクトは MIT に基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。

サードパーティのライブラリ

このプロジェクトでは、次のサードパーティ ライブラリを使用します。

• 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 に基づいてライセンスされています

貢献者

• 有馬高尾
• ウォランダーク
• ニコロリアヒム