InkWeaver 使い方完全解説｜マンガ自動アーカイブCLI・GUIツールの全機能

GitHubで注目を集めるInkWeaver（manga-synchronizer）は、マンガコレクターのためのデュアルインターフェース自動アーカイブツール。CLIで高度な自動化を、デスクトップGUIで直感的な管理を実現する。メタデータ自動埋め込み・重複排除・スケジュール実行に対応した次世代マンガ管理環境を紹介する。

GitHubで急上昇中の luqmanluqman7349-cloud/manga-synchronizer をご紹介します。スター数 151★ を獲得し、CLI分野で注目されているツールです。

InkWeaver（manga-synchronizer）とは？

InkWeaverは、マンガシリーズのチャプターを自動的に収集・整理・アーカイブするデュアルインターフェースツールです。プロジェクト名は「manga-synchronizer」ですが、ツール自体はInkWeaverという名称で、デスクトップアプリとCLIの両方から利用できます。

「コレクションは収集だけでなく保存の行為である」という哲学のもと、単なるダウンローダーではなく、構造化・検索可能・視覚的に整理されたデジタルライブラリを構築することを目指しています。MangaPlus等のソースから取得したチャプターに自動でメタデータを付与し、KomgaやKavitaなど外部ライブラリツールとの連携も念頭に置いて設計されています。

なお、本ツールは著作権法の範囲内での個人アーカイブ用途を想定しており、正規アクセス可能なコンテンツへの利用が前提です。利用前に各ソースの利用規約を必ず確認してください。

こんな人におすすめ:

エンジニア向け: CLIからJSON出力・パイプライン連携・スケジュール実行で既存の自動化ワークフローに統合できる
非エンジニア向け: デスクトップGUIでマンガコレクションを視覚的に管理・整理できる

manga-synchronizer（InkWeaver）の主な機能・特徴

デュアルインターフェース設計

PyQt6 + QtQuick製デスクトップアプリとフル機能CLIの2つのインターフェースを提供。GUIではカバーサムネイルのメーソングリッドでライブラリを閲覧でき、CLIでは自動化スクリプトやメディアパイプラインへの統合が可能です。

インテリジェントな重複排除と継続ダウンロード

すでにダウンロード済みのチャプターを自動スキップ（新バージョンが存在する場合は更新）。接続が途切れても最後に成功したチャンクから再開するリトライ・レジュームロジックを実装しており、帯域幅を無駄にしません。

構造化メタデータ自動埋め込み

チャプターごとにmetadata.jsonを自動生成し、シリーズタイトル・チャプター番号・公開日・ソース・チェックサムを記録します。Komga、Kavita、Calibreなど主要なマンガライブラリツールからそのまま読み込める形式です。

エクスポートプロファイル（CBZ / 画像 / PDF）

CBZ（タブレット最適）・生画像・PDFの3種類の出力形式に対応。~/.inkweaver/profiles.yamlでカスタムプロファイルを定義でき、用途に合わせた出力が可能です。

スケジュール実行・24時間バックグラウンド動作

毎日深夜3時に新チャプターを自動取得するなどのスケジュール設定が可能。バッテリー20%未満の際はスキップする電源対応機能も搭載しています。

InkWeaver の使い方・始め方

インストール手順

InkWeaverはPythonベースのツールです。まず Python 3.10以上と PyQt6 が必要です。

# Python と pip の確認
python3 --version   # 3.10+ を確認
pip3 --version

# インストール（公式サイトまたは pip）
pip install inkweaver

# または git からインストール
git clone https://github.com/luqmanluqman7349-cloud/manga-synchronizer.git
cd manga-synchronizer
pip install -e .

# インストール確認
inkweaver --version

注意: 最新のバイナリ・インストーラーはプロジェクト公式サイト（luqmanluqman7349-cloud.github.io/manga-synchronizer）で確認してください。

CLIによる基本操作

InkWeaverのCLIはコンポーザブルなコマンド体系を採用しています。

# マンガシリーズのフェッチ（チャプター1〜50）
inkweaver fetch --series "One Piece" --chapters 1-50 --output ./my_manga

# メタデータの更新（日本語メタデータへ切り替え）
inkweaver metadata --update --series "Berserk" --language jp

# スケジュール設定（毎日3時にNASへ自動ダウンロード）
inkweaver schedule --daily --time 03:00 --output /mnt/nas/manga

# 新チャプター監視（15分ごとにチェック）
inkweaver watch --series "Vinland Saga" --monitor --interval 900

# ドライランで動作確認（実際にはダウンロードしない）
inkweaver fetch --series "Attack on Titan" --dry-run

jq連携・JSON出力によるパイプライン統合

CLIはJSON出力に対応しており、jq・fzf・notify-send等のツールとシームレスに連携できます。

# 全シリーズの状態をJSON出力してjqでフィルタ
inkweaver fetch --series "Vinland Saga" --json | jq '.chapters[] | select(.status=="new")'

# 新着チャプターを取得してデスクトップ通知
inkweaver status --json | \
  jq -r '.[] | select(.new_chapters > 0) | "\(.title): \(.new_chapters)話"' | \
  while read line; do notify-send "InkWeaver" "$line"; done

# Kavita 向けに CBZ 形式で出力してライブラリに追加
inkweaver fetch --series "Berserk" --format cbz --output /mnt/kavita/manga/berserk

--dry-runフラグでダウンロード前のプレビューも可能で、安全に動作確認できます。

ローカルHTTPサーバーによるプレビュー機能

# ローカルブラウザやe-readerでライブストリーミング
inkweaver serve --port 8080 --library ./manga

LAN内の任意のデバイスからhttp://localhost:8080でライブラリにアクセスできます。タブレットやKindle Paperwhiteとの組み合わせで、読書環境を統一できます。

Komga・Kavita との連携ワークフロー（完全ガイド）

InkWeaverの最も強力な活用法は、KomgaやKavitaとの組み合わせです。以下に完全な連携ワークフローを紹介します。

# ステップ1: KomgaをDockerで起動
docker run -d \
  -p 25600:25600 \
  -v /mnt/nas/manga:/data \
  gotson/komga

# ステップ2: InkWeaverのスケジュール設定
# ~/.inkweaver/config.yaml
output_dir: /mnt/nas/manga
format: cbz
schedule:
  enabled: true
  time: "03:00"
  series:
    - "One Piece"
    - "Berserk"
    - "Vinland Saga"

# ステップ3: InkWeaverを起動
inkweaver daemon start

# ステップ4: Komga に新チャプターを自動スキャンさせる
# Komga の自動スキャン設定と InkWeaver のスケジュールを合わせる
# 例: 毎日 4:00 に Komga がスキャン → 3:00 に InkWeaver が取得完了

# ステップ5: 動作確認
inkweaver status --json | jq '.[] | {title: .title, chapters: .total_chapters, last_updated: .last_updated}'

Manga Synchronizer 日本語対応：活用事例

メディア自動化パイプラインへの組み込み

ホームサーバー（NAS・Raspberry Pi等）でメディア管理を行っているエンジニアが、マンガの自動アーカイブをJellyfin・Plex・Kavitaと連携するケース。inkweaver scheduleでcron代わりに定期取得し、Kavita/KomgaのSQLiteライブラリへ自動追加する構成が典型的です。

# cron の代わりに inkweaver schedule を使う例
# 従来: 0 3 * * * /usr/local/bin/manga-dl.sh
# InkWeaver: inkweaver schedule --daily --time 03:00 --output /mnt/nas/manga

電子書籍リーダー向けコレクション整理

iPadやKindle Paperwhiteで読んでいるマンガシリーズを、CBZ形式で統一管理したいコレクター向けのユースケース。エクスポートプロファイルで出力形式を揃えることで、複数デバイス間での読書体験を統一できます。

Komga・Kavita・他のマンガ管理ツールとの違い：なぜ今このツールか

Komga・Kavitaはダウンロード済みのファイルを整理・配信するライブラリサーバーです。InkWeaverはその「取得」フェーズを担うツールで、両者は競合ではなく補完関係にあります。InkWeaver → CBZ出力 → Komga/Kavitaで読む、というパイプラインが一般的な使い方です。

主要な競合ツールとの比較：

ツール	メタデータ自動生成	JSON出力	GUI対応	スケジュール	Komga連携
InkWeaver	✅ (metadata.json)	✅	✅ PyQt6	✅ 組み込み	✅ CBZ出力
Hakuneko	❌	❌	✅ Electron	❌	⚠️ 手動
MangaCraft	⚠️ 部分的	❌	✅	❌	⚠️ 手動
tachidesk	❌	✅ API	✅ Web UI	❌	✅
FMD2	⚠️	❌	✅	⚠️ 外部依存	⚠️ 手動

HakunekoやMangaCraftなどの既存マンガダウンローダーと比べると、InkWeaverはメタデータの構造化（metadata.json自動生成）とパイプラインへの統合性（JSON出力・環境変数連携）に重点を置いています。コレクション「整理」に重きを置く点が差別化ポイントです。

こんな人に向いている

ホームメディアサーバー管理者

NAS（Synology・QNAP等）やRaspberry PiでKomga/Kavitaを運用しているメディアエンジニアに最適です。inkweaver scheduleとCron連携で深夜自動取得を設定し、朝起きたら新チャプターが整理された状態でライブラリに追加されている運用が実現できます。

CLIベースの自動化が好きなデータエンジニア

JSONパイプライン・dry-runモード・ログレベル指定（silent〜trace）・環境変数でのAPIキー管理など、シェルスクリプトや自動化ツールと相性の良いCLI設計が特徴です。既存のメディア管理ワークフローへの統合が容易です。

本格的なコレクション整理を求めるマンガコレクター

単純な「ダウンロードツール」ではなく、コレクションの健全性チェック（破損画像・欠落ページ・壊れたメタデータの検出）・カバーアート自動取得・エクスポートプロファイルによる出力形式統一など、ライブラリ品質にこだわる方に向いています。

使う前に知っておきたいこと

実装ステータス: 本プロジェクトはGitHub上にはランディングページとREADMEが公開されており、実際のバイナリ・インストーラーはプロジェクト公式サイト（luqmanluqman7349-cloud.github.io/manga-synchronizer）から確認する必要があります。利用前に最新の実装状況を確認してください。

著作権に関する注意: 本ツールはユーザーが正規アクセス可能なコンテンツへの利用を前提としています。各国の著作権法・ソースサイトの利用規約を必ず確認し、コンプライアンスに注意して使用してください。日本では2021年著作権法改正により、違法アップロードコンテンツのダウンロードも違法となっています。

バッテリー対応: ラップトップ使用時、バッテリー残量20%未満ではダウンロードが自動スキップされます。長時間スケジュール実行を行う場合は電源接続を推奨します。

ライセンス: MITライセンスです。改変・再配布は自由ですが、ライセンスファイルの同梱が必要です。商用利用も可能ですが、コンテンツ自体の著作権は別途確認が必要です。

プラットフォーム: PyQt6ベースのデスクトップアプリはmacOS・Linux・Windowsに対応予定です（READMEより）。

まとめ

**InkWeaver（manga-synchronizer）**は、「コレクションは保存の行為である」という哲学のもと、マンガのアーカイブ・整理・メタデータ管理を自動化するツールです。デスクトップGUIとCLIのデュアルインターフェース、メタデータ自動埋め込み、KomgaやKavitaとの連携を念頭に置いた設計が特徴です。

Hakuneko・MangaCraft等の既存ツールと比べて、metadata.json自動生成とJSON出力によるパイプライン統合性が際立った差別化ポイントです。特にKomga/Kavitaと組み合わせたホームサーバー構成では、自動スケジュール取得からライブラリへの自動追加まで一括自動化できます。

ホームサーバーを運用するエンジニアや本格的なコレクション整理を求めるマンガ愛好家にとって、価値あるツールになる可能性があります。利用前にプロジェクトの公式ページで最新の実装状況と対応ソースを確認することをお勧めします。

GitHub でチェックする →

この技術を学ぶ

CLIに興味を持った方には、Udemyのオンラインコースもおすすめです。

🎓 関連するCLIコース一覧 — セール時（最大90%OFF）を狙うとお得です

InkWeaver 使い方完全解説｜マンガ自動アーカイブCLI・GUIツールの全機能

InkWeaver 使い方完全解説｜マンガ自動アーカイブCLI・GUIツールの全機能

InkWeaver（manga-synchronizer）とは？

manga-synchronizer（InkWeaver）の主な機能・特徴

デュアルインターフェース設計

インテリジェントな重複排除と継続ダウンロード

構造化メタデータ自動埋め込み

エクスポートプロファイル（CBZ / 画像 / PDF）

スケジュール実行・24時間バックグラウンド動作

InkWeaver の使い方・始め方

インストール手順

CLIによる基本操作

jq連携・JSON出力によるパイプライン統合

ローカルHTTPサーバーによるプレビュー機能

Komga・Kavita との連携ワークフロー（完全ガイド）

Manga Synchronizer 日本語対応：活用事例

メディア自動化パイプラインへの組み込み

電子書籍リーダー向けコレクション整理

Komga・Kavita・他のマンガ管理ツールとの違い：なぜ今このツールか

こんな人に向いている

ホームメディアサーバー管理者

CLIベースの自動化が好きなデータエンジニア

本格的なコレクション整理を求めるマンガコレクター

使う前に知っておきたいこと

関連ツール・おすすめサービス

まとめ

この技術を学ぶ

関連記事

torlink — ターミナルで完結するゼロ設定トレントクライアントの使い方

Aether とは？Rust製DPI・検閲回避クライアントの仕組みと使い方

usbliter8とは？Apple A12/A13デバイス向けブートロムエクスプロイトの概要