Xteink X3/X4 向けの日本語EPUB閲覧に特化したフォーク。
本家 crosspoint-reader (v1.2.0) をベースに、CJKフォークの改善を統合し、日本語の読書体験を向上させています。
- 動作保証はありません。 自己責任でご利用ください
- 現状 Xteink X3 でのみ動作確認しています。X4 での動作は未確認です
- 日本語専用フォークです。 中国語・韓国語のUIおよびフォントサポートは廃止しています。中国語環境をお使いの方は CJKフォーク をご利用ください
- 縦書き表示 —
vertical-rl対応、句読点・括弧の自動変換 - 日本語フォント — BIZ UDGothic、NotoSansJP 等をデバイスから直接ダウンロード
- EPUB内の画像・テーブル — JPEG/PNG画像やHTMLテーブルを本文中にそのまま表示
- 縦書き/横書き別設定 — フォント・サイズ・行間等を縦書き・横書きそれぞれで独立して設定可能
- 文字組みの改善 — 段落インデント、ルビ表示、濁音の表示修正
- デバイスからWiFi経由で青空文庫の作品を検索・ダウンロード
- お気に入り作家を登録して、ホーム画面からすぐにアクセス
- 青空文庫TXT→EPUB変換 — WebUIのファイル転送時に、青空文庫形式のTXTをEPUBに変換して転送可能（オプトイン、Shift_JIS自動判別、変換失敗時は元のTXTのまま転送）
- お気に入りの画像をスリープ画面に設定（WebUIからアップロード）
- 画像フィルターを選択可能（デフォルト: 白黒）
- 当月カレンダーをオーバーレイ表示（配置位置は設定で変更可能、初回のみWiFi接続による時刻同期が必要）
- 傾きページ送り — 端末を左右に傾けてページ送り（IMUセンサー搭載機のみ、設定で有効化）
- 手動画面リフレッシュ — 電源ボタン短押しで画面の残像をクリア
- 読書進捗アイコン — ファイル一覧・最近読んだ本リストで、未読/読書中/読了をアイコンで識別可能（95%以上読了で自動判定）
- WiFi経由の本体アップデート（OTA） — 設定メニューから本フォークの最新安定版を確認してそのまま更新可能（v0.1.12でダウンロードの安定性・失敗時の診断表示を大幅改善）
- SDカードからのファーム更新 — SD直下に
.binを置いて設定メニューから選択、または起動時のリカバリーモード（電源+左側面上ボタン）で直接起動 - Xteink X3 ハードウェアサポート（4階調グレースケール対応）
- DS3231 RTCチップによる時刻保持（RTC搭載機のみ）
- WiFi接続時のNTP時刻自動同期
- 各種バグ修正・安定性改善（縦書きでの超長段落EPUBのクラッシュ修正、スリープ壁紙が数秒後に淡くなる不具合の修正など）
近年出荷されている特定ロケール版のXteinkデバイス（海外向けモデル、AliExpressで販売されている個体の多く）は、工場出荷時にUSB経由のフラッシュが無効化されています。該当するデバイスでは、以下の Web Flasher・esptool 等によるUSB経由の書き込みは一切利用できません。
該当する場合は、本家CrossPointが提供する OTA Unlocker を使用してください。これはPCを一時的にWi-Fiホットスポット化し、純正ファームウェアのアップデート確認に割り込んでCrossPointを配信するツールです。
USBロック機での本フォーク導入手順:
- OTA Unlocker の指示に従い、本家CrossPointをデバイスに導入する
- SDカード直下に本フォークの
firmware.binを配置し、SDカードファーム更新機能で書き込む（または本フォーク導入後はOTA更新も利用可能）
⚠️ 文鎮化リスク: USBロック機はOTA・SDカード経由でしかファームウェアを書き換えられません。OTA更新やSDカード更新の手段を持たないファームウェアを書き込むと、復旧不能になる恐れがあります。本フォークはSDカードファーム更新・OTA更新の両方をサポートしています。
CrossPoint JP Flasher からブラウザ上で簡単にインストールできます。
- XteinkデバイスをUSB-Cケーブルでパソコンに接続
- Chrome または Edge で CrossPoint JP Flasher を開く
- ファームウェア（開発版 / 安定版）を選択し「インストール」をクリック
- シリアルポート選択ダイアログでデバイスを選択
対応ブラウザ: Chrome 89+, Edge 89+
- Releases ページから最新の Dev Build を開く
firmware.bin,bootloader.bin,partitions.binをダウンロード- Xteink をUSB-Cでパソコンに接続
- esptool.py または https://xteink.dve.al/ から書き込み
USB経由での書き込みができない場合、以下の2つのケースが考えられます。
前述の「USBロックされたデバイスについて」を参照してください。この場合はハードウェア側の仕様であり、USB経由での書き込みはできません。OTA Unlocker を使用してください。
本フォークの v0.1.9 未満のバージョン をお使いの場合、既知の不具合により以下の症状で更新ができない可能性があります：
- PC (macOS / Windows / Linux) で USB接続してもデバイスが認識されず、
pioや esptool でフラッシュできない - Web Flasher でもシリアルポート選択画面にデバイスが出てこない
原因: X3の充電状態判定が USB Serial の初期化条件になっていたため、バッテリー100%充電時に USB CDC が構成されないバグ（v0.1.9で修正済み）。詳細は PR #69 を参照。
リカバリー手順:
- OTA Xteink Unlocker にアクセスし、指示に従って Hatch Firmware をデバイスへフラッシュする（Wi-Fi OTA 経由）
- Hatch Firmware 起動後、SDカード直下に本フォークの
firmware.binを配置 - Hatch Firmware の SDファーム更新機能から
firmware.binを選択して書き込み
書き込み完了後は SDカードファーム更新機能・OTA更新が使えるようになるので、以降のアップデートは容易です。
デバイスの 設定 > フォントをダウンロード から日本語フォントをダウンロードできます（WiFi接続が必要）。 ダウンロードは同じフォント名を2回選択することでインストールが可能です。
| フォント | 特徴 |
|---|---|
| BIZ UDGothic | モリサワのユニバーサルデザインゴシック体。可読性が高く、電子ペーパーとの相性が良い。おすすめ |
| BIZ UD明朝 | モリサワのユニバーサルデザイン明朝体。小説や文芸作品の読書に最適 |
| NotoSansJP | Google製のゴシック体。文字カバレッジが広い |
ダウンロード後、設定 > 読書設定 > フォントファミリー からフォントを選択してください。
| フォーマット | 拡張子 | 説明 |
|---|---|---|
| EPUB | .epub |
主要な電子書籍形式。フルサポート（目次、脚注、画像、縦書き等） |
| XTC/XTCH | .xtc, .xtch |
Xteink独自形式。事前レンダリング済みページをそのまま表示 |
| BMP | .bmp |
モノクロBMP画像ビューア |
注: TXT/Markdown形式はSDカードフォント使用時のテキストレイアウト計算にパフォーマンス上の問題があるため、デバイス上で直接開くことはできません。ただし青空文庫形式のTXTは、WebUIのファイル転送時にEPUBへ変換して取り込むことができます（前述「青空文庫」参照）。
- デバイスから直接ダウンロード: 設定メニュー > 青空文庫 からWiFi経由で検索・ダウンロード可能
- 青空文庫 EPUB変換 - 著作権切れの日本文学をEPUB形式で入手可能（PC経由）
詳細な操作方法については USER_GUIDE.md を参照してください。
| プロジェクト | 内容 |
|---|---|
| crosspoint-reader | 本家 (v1.2.0 ベース) |
| crosspoint-reader-cjk | CJKフォーク（文字間隔修正、段落インデント等） |
| PR #1392 | SDカードフォント（22ファミリー、CJK対応） |
| PR #875 | Xteink X3 ハードウェアサポート |