PageScribe: KOReader向けの筆記とオフライン辞書音声

電子書籍に書き込みたかった。だからPageScribeを作った。

思考のためのペン、テキストのための指、そしてオプションのオフライン発音—日常の読書から生まれた2つのオープンソースKOReaderプラグイン。

電子書籍リーダーにちょっとしたことを求めていました：ある箇所に素早く考えを書き込み、そのまま読書を続けること。また、指で文を選択し、ハイライトして、数秒ごとにモードを変更することなく単語を調べること。

それがPageScribe、私のKOReader向け手書きプラグイン、そしてDictionary Audio、オフライン発音用の別プラグインになりました。これらは連携できますが、どちらも相手を必要としません。これはBuildsの最初の投稿で、私が作ったもの、その背後にある決定、そしてまだ作業が必要なことを共有します。

ペンが書き、指が選択する。

最も役立つインタラクションは、最もシンプルなものだとわかりました。PageScribeのデフォルトの「ペンが書く・指が選択する」モードでは、ペンは描画し、指の長押しとドラッグはKOReaderのネイティブなテキスト選択を保持します。これは、通常のテキストハイライト、辞書検索、テキストメモが引き続き利用可能であることを意味します。

［画像: PageScribeのペンツールとインラインコントロール、レンダリングされたUIプレビュー］

ペンのコントロール・レンダリングされたUIプレビュー。

ここでは2種類のハイライトがあります。マーカーはページ上にフリーハンドのオーバーレイを描画します。指でテキストを選択すると、KOReaderの通常のテキスト注釈が作成されます。この区別を明確に保つことが重要です：時にはアイデアの周りにゆるいマークを付けたいときがあり、時には後で見つけられる正確な文が欲しいときがあります。

PageScribeは、サポートされているKOReaderバージョンでは、消しゴム、元に戻す、ページノート、HTMLノートブックエクスポート、PDFインクエクスポートも提供します。これは、SMUsamaShahのオリジナルのFinger Inkプロジェクトを基盤としており、そのオープンソースの基盤がこの作業を可能にしました。継承されたAGPL-3.0ライセンスと履歴は保持されます。

本にスペースを残すツールバー

インターフェースはいくつかのイテレーションを経ました。円形のメニューは魅力的でしたが、使用中にどのツールがアクティブか、次のタップが何をするのかが十分に明確ではありませんでした。より大きなトレイはアクションを明確にしましたが、テキストを覆いすぎました。

現在の方法は、右端の中央付近にある小さな円形の筆記ランチャーから始まります。それをタップすると、より大きなインラインツールバーが開きます。ペンの太さ、入力モード、色がツールの隣に展開され、ページが表示されたままになります。アクティブなツールには、塗りつぶされたボタンとチェックマークがあります。ランチャーとトレイはどちらもドラッグ可能で、×はトレイを閉じますが、ランチャーは利用可能なままです。

［画像: ペン、テキスト選択、色、トレイ、オプションのオーディオのアニメーションウォークスルー］

ツールを一目で確認・レンダリングされたUIプレビュー、デバイスのパフォーマンス記録ではありません。

ペンとマーカーの色は別々に記憶されます。カラーデバイスはパレットを表示できますが、モノクロディスプレイは読みやすい黒インクを使用します。HTMLおよびPDFエクスポートは選択されたストロークの色を保持します。これにより、コントロールの理解に不可欠でなくても、色が役立ちます。

発音はオプションであるべき

読書中、見慣れない単語を聞きたいとも思いました。Dictionary Audioは、Androidのネイティブ辞書検索に「英語を聞く」と「スペイン語を聞く」のアクションを追加します。スペイン語は翻訳された単語の選択肢と設定可能な再生速度を提供し、英語とスペイン語は個別に有効になります。

スペイン語パックは、メキシコスペイン語の合成音声を使用します。これは、単語が選択されるたびにオンライン音声リクエストを行うのではなく、事前に生成されローカルで再生されます。定義、翻訳データ、発音パックは別々のダウンロードです。プラグインをインストールするだけでは、それらはインストールされません。

［画像: Dictionary Audioの発音選択肢、レンダリングされたUIプレビュー］

オプションのDictionary Audio・レンダリングされたUIプレビュー。

音声を発音専用のリポジトリに分割したので、発音だけを求める人も、筆記ツールバーなしで使用できます。両方のプラグインがインストールされている場合、PageScribeはオーディオショートカットを提供します。PageScribeのみがインストールされている場合、筆記は単独で機能します。

もっと説明する必要があったインストール詳細

Redditの読者から、PageScribe ZIPにpagescribe.kopluginではなくfingerink.kopluginが含まれている理由を尋ねられました。それはもっともなフィードバックでした。製品名は変更されましたが、設定、メモ、アップグレードを保持するためにインストールフォルダは維持されました。

正確なインストール方法は次のとおりです。pagescribe.koplugin.zipリリースアセットをダウンロードし、解凍し、fingerink.kopluginフォルダ全体をKOReaderのpluginsディレクトリにコピーします。結果のファイルパスは koreader/plugins/fingerink.koplugin/main.lua である必要があります。フォルダ名を変更したり、二重にネストしたりしないでください。KOReader内ではPageScribeとして表示されます。

KOReaderを完全に再起動し、必要に応じてプラグインマネージャーでPageScribeを有効にし、書籍を開きます。ランチャーはリーダー内に表示され、ライブラリやホーム画面には表示されません。それをタップし、ペンを選択し、入力モードを確認します。読書に戻ると通常の読書に戻ります。Dictionary Audioには独自のZIP、インストール手順、パックがあります。

READMEは現在、そのフォルダの説明で始まっており、ディレクトリツリーが含まれ、最初の使用方法を説明しています。機能している機能には、ダウンロードから最初の成功したアクションまでの明確なパスが必要です。

テストされたこと—そして残っていること

開発と実践的な使用は、Viwoods AiPaper MiniとKOReader v2026.07.2-206を中心に展開されています。ネイティブペン入力には互換性のあるデバイスと、スタイラスコールバックAPIを公開するKOReaderビルドが必要です。指での描画にはKOReader 2026.03以降が必要です。PDFインクエクスポートには2026.07以降が必要です。競合する筆記キャプチャプラグインは、PageScribeのテスト中は無効にする必要があります。

Boox Tab Ultra Cのテストは進行中です。PageScribeランチャーが表示され、英語の音声が再生されます。そのデバイスではスペイン語の再生がミュートされており、交換用のPCM WAVパックが転送されチェックサム検証されましたが、音声再生の確認はまだです。すべてのAndroidハードウェアが検証済みであると提示するのではなく、その制限を可視的に表示しています。

リフロー可能な書籍での筆記はページレイアウトに依存します。フォントサイズ、マージン、または向きを変更すると、そのアラインメントが変わる可能性があります。既存のインクのためにレイアウトを安定させてください。これらはページオーバーレイであり、リフローごとに文を自動的に追従する筆記ではありません。

この記事に付随する画像とアニメーションは、レンダリングされたUIプレビューとラベル付けされており、説明的な書籍ページを使用しています。それらはコントロールを説明するためのものであり、写真や接続されたデバイスのキャプチャではなく、遅延やパームリジェクションのパフォーマンスを示していません。

ビルドを試す

PageScribe ↗

Dictionary Audio ↗

Original Finger Ink ↗

どちらかのプラグインを試した場合は、お使いのデバイス、KOReaderバージョン、入力モード、そして機能したか失敗した正確なステップを共有してください。ペン/指の動作、ツールバーの配置、発音再生に関するレポートは、個人的なビルドをより多くの人が利用できるものに変えるのに役立ちます。