macOS で Comistream Reader をセットアップ

Comistream Reader と言うものがでた。これはコンテンツリーダーらしい。

手元のコンテンツを手軽に Web ブラウザから閲覧できる Comistream Reader がリリースされていたので、早速じぶんの環境にもインストールしてみました。これを iPad mini の Safari からアクセスすることによってコンテンツを手軽に消費できるようになるらしいので楽しみ。この Comistream Reader はデフォルトで TCP 8080 ポートを使用するけど、Docker コンテナ作成時にポートを変えることもできるみたい。

環境：
Mac mini M1, 2020 / 8GB / macOS Ventura 13.6.1
Docker version 27.3.1, build ce12230

Comistream Reader はオープンソースとして GitHub に公開されていて、無料で利用することができます。自炊した書籍が .zip に圧縮されていても Comistream はそれらを自動的に展開して Web ブラウザから閲覧できるようにします。また、表紙のサムネイルを作る機能もあります。

Comistream Reader - ヘビーユーザーのためのオープンソースコミックリーダー

更新履歴

2024年11月12日 … Docker Desktop のリソース設定を追記
2024年11月9日 … 掲載

はじめに

Docker Desktop のインストールページに「十分な機能性を確保するためには、Rosetta 2 のインストールをお勧めします」と書いてあるため、念のため Rosetta 2 をインストールします。

Mac に Rosetta をインストールする必要がある場合 - Apple サポート (日本)

1. ターミナル.app を開く
2. softwareupdate --install-rosetta と入力
3. Type A and press return to agree: と聞かれたら A と入力
4. Install of Rosetta 2 finished successfully でインストール完了

Docker Desktop の Mac をダウンロード

Docker Desktop の Mac へのインストール | Docker ドキュメント

1. Docker.dmg をダウンロード
2. Docker.app をアプリケーションフォルダにコピー
3. アプリケーションフォルダから Docker.app を右クリックで "開く"
4. 開いてもよろしいですか？→ 開くをクリック
5. Accept をクリック
6. Use recommended settings (requires password) を選択し、Finish をクリック
7. Mac のパスワードを入力
8. ローカルネットワーク上のデバイスを見つけることを許可
9. Welcome to Docker で右上の Skip をクリック
10. Welcome Survey で右上の Skip をクリック

詳しくは下記を参照

Comistream の Docker コンテナをインストール

デフォルトではシステムディスクにコンテナが作成されてしまうので、事前に保存先の設定を変更します。

1. 容量の大きいボリュームに Docker フォルダ(名前は任意)を作成
2. Docker Desktop (Docker.app) を開く
3 右上の歯車アイコン(Settings) > Resources > Advanced
4. Disk image location で Browse をクリック
5. 上記、作成したフォルダを再指定
6. 設定を反映するために Apply & restart をクリック
7. Move disk image > Yes, move it をクリック
8. 右上の × から Settings を閉じる
9. Docker Engine が再起動するのを待つ
10. しばらく待っていると左下のステータスが Engine stopped から Engine running に変わる

ディスクイメージの移行処理が完了するまでに結構時間がかかる場合がある。指定したフォルダに Docker.raw ファイルが作成されていることを確認し、ファイルサイズが 64GB まで成長するのを待つ必要があります。

次に、Docker Desktop をそのままの設定で使っていると Comistream のサムネイル作成時などに CPU をフルに使ってしまい、その他のパフォーマンスが低下することがあるので、リソースもある程度調整しておく。

Comistream 動作中は、高性能コアの CPU が優先的に使用されるようなので、高性能コアの数に制限する。これにより高効率コアが常にフリーとなって Mac のパフォーマンスが向上する。
メモリは可能な限り多く適用するが、最大にすることはしない。使用メモリのバランスを見つつ調整していくとよいかも？
スワップはとりあえず最大にしておくｗ

Docker コンテナインストール手順

1. ターミナル.app を開く
2. インストールコマンドを入力

docker run -d -p 8080:80 --name comistream ghcr.io/sorshi/comistream-reader/comistream-reader:latest

もし、コンテンツが保存されている領域が決まっているなら -v オプションの後にパスを入力します。これはあとから変更出来ないので Docker を作成する前に必ずオプションでパス追加してください。

docker run -d -p 8080:80 -v /Volumes/Drobo/Contents:/home/user/public/nas --restart unless-stopped --name comistream ghcr.io/sorshi/comistream-reader/comistream-reader:latest

3. Docker が作成されると Containers に comistream が作成される
4. comistream をクリック
5. Exec タブをクリック
6. unrar が入っていないので dnf install -y unrar でインストール
7. Complete! でインストール完了
8. Safari などのブラウザから http://localhost:8080 にアクセス
9. 初期管理者パスワード設定
10. ユーザー名とパスワードを入力して設定保存
11. Comistream 環境設定を設定して、上にある [設定保存] をクリック

【ディレクトリ設定】
webRoot: /home/user/public (変えない)
publicDir: /nas (変えない)
sharePath: /home/user/public/nas (インストール時のパス) - 基本変えないけど要確認
comistream_tool_dir: /home/user/comistream (変えない)
comistream_tmp_dir_root: /dev/shm/comistream_temp (変えない)
cover_subDir: コンテンツルートにあるフォルダを列挙（半角スペース区切り）
　例）Desktop Documents Movies Music 電子書籍

【コマンド設定】
unrar: /usr/bin/unrar (消えている場合があったので念のため確認)

環境設定: http://localhost:8080/cgi-bin/comistream.php?mode=config

12. Docker Desktop の Exec から /home/user/comistream/code/make_image_run.sh を実行
13. コンテンツ量により時間がかかるので後は放置