superbook-pdf

Fork of dnobori/DN_SuperBook_PDF_Converter

Rust で完全リライトしたスキャン書籍 PDF 高品質化ツール

オリジナル著者: 登 大遊 (Daiyuu Nobori) Rust リライト: clearclown ライセンス: AGPL v3.0

Before / After

RealESRGAN による AI 超解像で、文字のエッジが鮮明になり、読みやすさが大幅に向上

特徴

• Rust 実装 - C# 版を完全リライト。メモリ効率大幅改善
• AI 超解像 - RealESRGAN で画像を高解像度化
• 日本語 OCR - YomiToku による文字認識
• 傾き補正 - 大津二値化 + Hough 変換で自動補正
• Web UI - ブラウザから操作可能

必要なもの

必須

AI機能を使う場合 (オプション)

インストール

1. システム依存パッケージ

# Ubuntu/Debian
sudo apt update
sudo apt install -y poppler-utils python3 python3-venv

# Fedora
sudo dnf install -y poppler-utils python3

2. Rust ツールのインストール

crates.io からインストール (推奨):

cargo install superbook-pdf --features web

ソースからビルド:

git clone https://github.com/clearclown/DN_SuperBook_PDF_Converter_Linux.git
cd DN_SuperBook_PDF_Converter_Linux/superbook-pdf
cargo build --release --features web

バイナリは target/release/superbook-pdf に生成されます。

3. AI機能のセットアップ (オプション)

AI超解像 (RealESRGAN) と OCR (YomiToku) を使用する場合:

cd ai_bridge

# Python 仮想環境を作成
python3 -m venv .venv
source .venv/bin/activate

# GPU版 PyTorch をインストール (NVIDIA GPU使用時)
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121

# AI依存パッケージをインストール
pip install -r requirements.txt

実行時に環境変数を設定:

export SUPERBOOK_VENV=/path/to/superbook-pdf/ai_bridge/.venv

4. Docker/Podman で実行 (オプション)

GPU対応コンテナで簡単にセットアップできます:

cd superbook-pdf

# Docker
docker compose up -d

# Podman (4.7+)
podman compose up -d

# ブラウザで http://localhost:8080 を開く

単体コンテナで実行:

# ビルド
podman build -t superbook-pdf .

# 実行 (GPU使用)
podman run --rm -it --gpus all \
  -v ./input:/data/input:ro \
  -v ./output:/data/output:rw \
  superbook-pdf convert /data/input/book.pdf -o /data/output/

使い方

基本的な変換

# シンプルな変換 (傾き補正 + AI超解像)
./target/release/superbook-pdf convert input.pdf -o output/

# 高品質変換 (全オプション有効 + OCR)
./target/release/superbook-pdf convert input.pdf -o output/ --advanced --ocr

# GPU無効化 (CPUのみで処理)
./target/release/superbook-pdf convert input.pdf -o output/ --no-gpu

オプション一覧

superbook-pdf convert [OPTIONS] <INPUT>

引数:
  <INPUT>              入力PDFファイル

オプション:
  -o, --output <DIR>   出力ディレクトリ [デフォルト: ./output]
  --advanced           高品質処理を有効化
  --ocr                OCR を有効化 (YomiToku)
  --no-gpu             GPU を無効化
  --no-upscale         AI超解像を無効化
  --no-deskew          傾き補正を無効化
  --max-pages <N>      処理ページ数を制限 (テスト用)
  -v, --verbose        詳細出力 (-vvv で最大)
  -h, --help           ヘルプ表示

Web UI

./target/release/superbook-pdf serve --port 8080
# ブラウザで http://localhost:8080 を開く

処理パイプライン

1. PDF画像抽出 - pdftoppm で 300 DPI 抽出
2. マージントリム - 0.5% の余白を除去
3. AI超解像 - RealESRGAN で 2x アップスケール
4. 傾き補正 - 大津二値化 + Hough変換
5. カラー補正 - 紙色の白化 (--advanced)
6. PDF生成 - メタデータ同期
7. OCR - YomiToku (--ocr)

トラブルシューティング

開発

# テスト実行
cargo test --features web

# フォーマット
cargo fmt && cargo clippy

ライセンス

AGPL v3.0 - LICENSE

謝辞

• 登 大遊 (Daiyuu Nobori) - オリジナル実装
• RealESRGAN - AI超解像
• YomiToku - 日本語OCR