narou.rb 導入ガイド (2026年4月時点)

narou.rb 導入 & トラブルシューティングガイド

⚠️ 注記

本記事は「narou.rb」公式マニュアルではありません。

以下の記載は 2025-12-21 時点の暫定対応であり、適用は自己責任 でお願いします。

必ず narou.rb 公式 Wiki や Issues を確認し、公式の最新情報を優先してください。

ツール本体が更新された場合、本記事の手動修正は不要になる可能性があります。

検証環境: Windows 11, Ruby 3.4.1, narou 3.9.1

Web小説ダウンローダー narou.rb を導入し、AozoraEpub3 と連携させるための手順です。

💡 おすすめ: narou.rb 互換のツール narou.rs（Rust 実装）は、機能更新やセキュリティ修正が活発に続いており、これから使い始めるなら narou.rs のほうが安心です。narou.rb がうまく動かない場合の代替としても使えます。 👉 narou.rs 導入ガイド（画像付き）

現行の narou.rb（v3.9.1 時点）では、以下の既知の不具合がコミュニティで報告されています：

依存ライブラリ（tilt）のバージョン不整合による起動エラー
「小説家になろう」サイト仕様変更への未対応（目次が取れない）

本ガイドは、これらに対するコミュニティから共有されている回避策をまとめたものです。

公式インストール手順（必須ツールなど）は、以下も参照してください。kindlegen については現行では send to kindle / email での登録が使えないため本ガイドでは扱いません。

narou.rb 公式 Wiki - インストール

1. Ruby のインストール（Windowsの例）

RubyInstaller for Windows にアクセスします。
Ruby+Devkit 3.4.x (x64) （WITH DEVKIT と書かれているもの）をダウンロードして実行します。
インストール画面の途中にある 「MSYS2 development toolchain」 のチェックボックスは入れたままにしてください。
インストール完了後、PowerShell で ruby -v と入力し、バージョンが表示されればOKです。

macOS/Linux でも動作しますが、本記事では主に Windows 環境について解説します。

2. narou.rb のインストール

PowerShell (またはコマンドプロンプト) で以下のコマンドを実行します。

gem install narou

※ インストール直後は依存ライブラリの不整合で起動しない場合があります。エラーが出る場合は4節以降の修正を行ってください。

3. AozoraEpub3 の準備

本ソフトウェア（AozoraEpub3-JDK21）を動作させるには Java 25 を推奨します（Java 21 以降であれば動作します）。

Java の確認
コマンドプロンプトで java -version を実行し、バージョンが表示されるか確認してください。
- まだインストールしていない場合: 👉 トップページのインストールガイド を参照して導入してください。
ソフトウェアのダウンロード
- ダウンロードページ (Releases) から最新の zip ファイルをダウンロードします。
- 任意の場所（例: C:\Tools\AozoraEpub3 など）に解凍します。

Point: パス（フォルダの場所）に日本語やスペースが含まれていると、うまく動作しない場合があります。なるべく半角英数字だけの場所に置くことを推奨します。

4. 起動エラーの修正（tilt/erubis）【既知の不具合】

症状: narou コマンド実行時に cannot load such file -- tilt/erubis というエラーが出る。

原因: narou 3.9.1 が使用するライブラリのバージョンが新しすぎるため。古いバージョンに入れ替えることで回避します。

回避手順:

現在の tilt を削除します:
```
gem uninstall tilt
```
（”Successfully uninstalled…” と表示されればOK）
対策バージョン (2.4.0) をインストールします:
```
gem install tilt -v 2.4.0
```

参考:

narou Issue #443 — 同様の報告
GEM の実体パスは環境で異なります。必要に応じて gem env home で GEM_HOME を確認してください。

5. 「小説家になろう」目次取得エラーの修正【暫定回避策】

症状: ダウンロードを実行しても、目次や本文が取得できず終了してしまう。

原因: 「小説家になろう」側の仕様変更に narou の設定ファイルが未対応のため。有志によって修正された設定ファイル（YAML）に手動で差し替えます。

回避手順:

コミュニティから共有されている暫定修正（PR #446 ベース）を適用します。

1. 修正ファイルをダウンロード 以下のリンク先（GitHub）を開き、手順に従って 2つのファイル をダウンロードしてください。

👉 Pull Request #446 - Files changed

ファイル一覧から webnovel/ncode.syosetu.com.yaml を探します。
右上の「…」（三点リーダー）をクリックし、「View file」を選択します。
ファイルの中身が表示されたら、右上の「Download raw file」（↓矢印アイコン）をクリックして保存します。
もう一つのファイル webnovel/novel18.syosetu.com.yaml も同様にダウンロードします。

2. ファイルの上書き ダウンロードした2つのファイルを、narou.rb がインストールされているフォルダの中に上書き保存（コピペ）します。

フォルダの場所（例）: C:\Ruby34-x64\lib\ruby\gems\3.4.0\gems\narou-3.9.1\webnovel (※ Rubyのバージョン部分は環境に合わせて読み替えてください)

推奨: 上書きする前に、元々あったファイルを「～.yaml.bak」のように名前を変えてバックアップしておくと安心です。

6. カクヨム目次取得エラーの修正【暫定回避策】

症状: カクヨムの作品をダウンロード・更新しようとするとエラーが発生し、目次や本文が取得できない。

原因: カクヨム側のサイト構造変更（内部データキー tableOfContents → tableOfContentsV2）に narou.rb の設定ファイルが未対応のため。有志によって修正されたプルリクエストが提出されていますが、2026-04-09 時点でまだマージされていません。

回避手順:

コミュニティから共有されている暫定修正（PR #452 ベース）を適用します。

1. 修正ファイルをダウンロード 以下のリンク先（GitHub）を開き、手順に従って 1つのファイル をダウンロードしてください。

👉 Pull Request #452 - Files changed

ファイル一覧から webnovel/kakuyomu.jp.yaml を探します。
右上の「…」（三点リーダー）をクリックし、「View file」を選択します。
ファイルの中身が表示されたら、右上の「Download raw file」（↓矢印アイコン）をクリックして保存します。

2. ファイルの上書き ダウンロードした kakuyomu.jp.yaml を、narou.rb がインストールされているフォルダの中に上書き保存（コピペ）します。

フォルダの場所（例）: C:\Ruby34-x64\lib\ruby\gems\3.4.0\gems\narou-3.9.1\webnovel (※ Rubyのバージョン部分は環境に合わせて読み替えてください)

推奨: 上書きする前に、元々あったファイルを「kakuyomu.jp.yaml.bak」のように名前を変えてバックアップしておくと安心です。

参考:

narou Issue (PR #452) — 同様の報告と修正

7. 初期化と AozoraEpub3 の連携

小説保存用のフォルダを作成し、初期化コマンドを実行します。この中で AozoraEpub3 との連携設定も行います。

mkdir MyNovels
cd MyNovels
narou init

コマンドを実行すると、いくつか設定項目を聞かれます。

「AozoraEpub3のフォルダを指定して下さい」 と表示されます。
手順3で用意した AozoraEpub3.jar が入っているフォルダのパス を入力して Enter を押します。
- 例: C:\Tools\AozoraEpub3
- エクスプローラからフォルダをドラッグ＆ドロップしても入力できます。

これで narou.rb が AozoraEpub3 の場所を記憶し、自動連携の設定は完了です。

補足: 設定ファイルについて 初期化後、AozoraEpub3.jar と同じディレクトリの AozoraEpub3.ini が参照されます（存在しない場合は新規作成されます）。行間やフォントサイズなどの変換設定を変更したい場合は、このファイルを編集するか、AozoraEpub3 の GUI から設定を保存してください。

注意: AozoraEpub3 の GUI を終了すると、このファイルは GUI の設定内容で全体が書き直されます（手で書いたコメントは残りません）。GUI と手編集を併用する場合は、GUI を閉じた後に編集してください。

補足: 変換完了後に自動でプレビューを開く（v1.5.1〜） GUI の「変換完了後に自動でプレビューを開く」にチェックを入れる（または AozoraEpub3.ini に AutoPreview=1 を書く）と、narou.rb / narou.rs 経由の変換でも、変換が終わるたびに出来上がった EPUB がブラウザでプレビュー表示されます。プレビューは別プロセスで開くため narou.rb の処理は止まりません。ブラウザのタブを閉じればプレビュー用のプロセスも自動終了します。なお narou update などで複数作品を一括変換すると作品ごとにタブが開くので、一括処理の間はオフにしておくのがおすすめです。

8. トラブルシュートのヒント

バージョン確認:
- gem list tilt (2.4.0 であること)
- gem list narou (3.9.1 であること)
設定ファイルの場所がわからない: gem env home でインストール先のベースフォルダを確認
公式ヘルプ: narou.rb Wiki

「JavaがインストールされていないかAozoraEpub3実行時にエラーが発生しました」と出る

Java は正しく入っているのにこのメッセージが出る場合、実際には EPUB の出力に失敗している可能性があります。

narou.rb は AozoraEpub3 の終了コードで成否を判定しますが、「AozoraEpub3 はエラーでも終了コード 0 を返す」という前提で作られているため、 0 以外はすべて「Java が動かなかった」と解釈してこのメッセージを表示します（narou.rb 3.9.1 / lib/novelconverter.rb）。

AozoraEpub3 は v1.3.7-jdk21 から、変換に失敗した場合に終了コード 1 を返すようになりました。これは意図した変更です。v1.3.6-jdk21 以前は失敗しても 0 を返していたため、 壊れた .epub が「成功」として narou.rb に取り込まれていました。

真の原因を確認する方法: narou.rb はこのメッセージの直前に、AozoraEpub3 の標準出力と標準エラー出力をそのまま全文表示します（novelconverter.rb:197）。そこに エラーが発生しました : ... の行があれば、それが実際の失敗理由です。

narou convert -v <ID>（verbose）はこの場面では追加情報になりません。 narou.rb は終了コードが 0 以外だと verbose 出力ブロックに到達する前に return :error するためです（novelconverter.rb:195-200 と :218-223）。ただし上記のとおり全出力は既に表示されているので、-v なしで原因を確認できます。

よくある原因: 出力先ディスクの空き容量不足 / 出力先ディレクトリの書き込み権限がない。

なお、画像のデコード失敗や表紙の取得失敗は従来どおり局所的に処理が続行されるため、この失敗の原因にはなりません（ログには 画像読み込みエラー: ... のようなエラー行が出ますが、変換自体は続行され終了コードは 0 のままです）。

逆に、Java が本当に入っていない場合も同じメッセージになります。java -version で確認してください。

参考リンク

narou.rb 公式 Wiki — 公式マニュアル・最新情報
narou.rb Issues — バグ報告・既知問題
narou.rb 公式掲示板 — ユーザーコミュニティ・情報交換
AozoraEpub3 使い方 — AozoraEpub3 の詳細設定
Send to Kindle (Web/メール) — Kindleで読む場合に便利。※narou.rb の既知障害として、自動メール送信時に電子書籍タイトルが数字化する事象があります。

情報更新日: 2026-04-09 | 本記事は公式ではなく、コミュニティ情報をまとめたものです。