Repository navigation
Releases
JoyRead v1.3.1
English (default) · 展开查看完整中文说明 · 日本語の全文は下を展開してください。
简体中文 · 欣阅 1.3.1
更清晰的阅读界面,更顺畅的页面准备。欣阅 1.3.1 优化详情与导航面板、进度条和多书拖动预览,并改进可随机访问压缩源的后台加载。
本次更新
- 详情与 Topic 面板: 增加固定标题和关闭按钮,调整工具栏间距与详情内容宽度。关闭按钮无常驻边框,悬停和按下时提供更清晰的反馈。
- 更协调的半透明界面: 调整面板、菜单项、操作按钮和选中状态的底色与细边框。Topic 选择器保留白色底色,与灰色切换开关区分。
- 更清楚的阅读进度: 统一阅读器、书籍卡片和详情页的已读/未读配色。阅读器滑块手柄加长至 22 × 10 px,上下控制栏采用统一半透明底色与细分隔线。
- 缩略图选区: 图片和页码作为完整选区,修正交互高亮的上、左、右留白,让悬停和选中反馈更一致。
- 多书自定义排序: 浮动预览改为紧凑的封面与标题扇形卡片,显示选择数量并保持稳定的指针偏移。
- 后台加载调度: 对已确认支持随机访问的非固实压缩源,限量并发准备页面和缩略图,优先处理当前可见内容。快速跳页或关闭后淘汰过期请求,避免旧结果重新显示。固实、能力不明的压缩源及 PDF 保持原有串行准备策略。
- 使用文档: 补充完整中文、日文手册,澄清标签创建和不同系统的存储路径。
- Windows 文字排版: 修正省略文字标签在字体行距小于完整行框时少分配 1 px 的问题,保留完整文字高度,不放大面板或控件。
- 图片格式兼容: 旧版 Qt 无法加载原生解码库时,在后台使用已有的 Pillow 解码并预缩放,修复 Ubuntu ARM64 的 WebP 阅读、缩略图与封面预览。
下载与安装
在本页底部的 Assets(附件) 中选择适合系统的安装包:
| 系统 | 安装包 | 要求 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+,不提供 Intel 版本 |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
基于 Ubuntu 22.04 构建 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
基于 Ubuntu 22.04 构建 |
SHA256SUMS 提供安装包校验值;build-info.json 记录版本、实际构建提交和逐平台构建来源。Linux 包并不保证兼容所有发行版。
macOS 首次启动: 打开 DMG,把 JoyRead 拖进应用程序文件夹,再从该文件夹启动。应用使用 ad-hoc 签名,未经过 Apple 公证。如果系统提示无法验证应用,在确认下载来源后:
- 点击**「完成」**,不要点击「移到废纸篓」。
- 打开苹果菜单 → 系统设置 → 隐私与安全性。
- 在**「安全性」**中找到 JoyRead 被阻止的提示。
- 点击**「仍要打开」**,按提示确认或验证身份。
安装新副本后可能需要再次确认。如果 Launchpad 尚未显示,请先从「应用程序」直接打开。
Windows: 运行 EXE 安装程序。安装包没有受信任的代码签名;如果出现 SmartScreen 提示,确认来源后选择**「更多信息 → 仍要运行」**。
Ubuntu: 在下载目录打开终端,按架构选择命令。图形安装器可能卡在“正在准备”,请使用 APT:
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.1-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.1-linux-arm64.deb升级与兼容性
从 1.3.0 升级不新增数据库迁移,保留书库、合集、标签、自定义排序、封面、阅读进度和每本书的阅读设置。建议升级前备份书库。预加载默认仍为前 4/后 8;Windows 后台模式及自动空闲清理默认保持开启。支持 ZIP/CBZ、7z/CB7、RAR/CBR 和 PDF,EPUB 仍未启用。
验证
四平台在构建 38928032902中分别先测试发行配置,再构建安装包;使用同一冻结源提交 4847ff1ddecf0bb8281670b6741c7ab8f28145c1 和 Python 3.12.9,EPUB 门控保持关闭。
| 平台 | 测试通过 | 跳过 | 安装包状态 |
|---|---|---|---|
| macOS arm64 | 2024 | 12 | DMG 构建成功 |
| Windows x64 | 2015 | 21 | EXE 构建成功 |
| Linux amd64 | 2026 | 10 | DEB 构建成功 |
| Linux arm64 | 2026 | 10 | DEB 构建成功 |
两个 Ubuntu 安装包均通过 APT 安装、隔离书库启动和 WebP Reader 首帧烟测;amd64 的 289 个、arm64 的 288 个 ELF 文件均满足 glibc ≤ 2.35。四份安装包的版本、架构、完整构建提交和 SHA-256 均已核对,逐平台来源保存在 build-info.json。
独立回归 CI的五个任务全部通过,另覆盖 Ubuntu 24.04 和 macOS 的 EPUB 额外依赖配置。本机最终 125% 离屏 UI 及图片链路检查为 145 项通过;这些自动化结果不替代桌面手动验收。
手动验收:维护者于 2026-10-20 确认 macOS、Windows、Ubuntu 三端测试均通过。 CI 使用离屏环境,与桌面手动验收分开记录。1.3.1 作为稳定版发布。
已知限制
极大尺寸的渐进 JPEG 页面在解码时仍可能明显增加进程内存。预缩放与缓存预算正常,进一步的内存优化已列为低优先级后续工作。
欣阅使用 GPL-3.0-only 许可证。
日本語 · ジョイヨミ 1.3.1
読書画面を見やすく、ページの準備をよりスムーズに。ジョイヨミ 1.3.1 では、詳細・ナビゲーションパネル、進行バー、複数冊のドラッグ表示を調整し、ランダムアクセス可能な圧縮元のバックグラウンド読み込みを改善しました。
更新内容
- 詳細・Topic パネル: 固定の見出しと閉じるボタンを追加し、ツールバーの余白と詳細領域の幅を調整しました。閉じるボタンの枠は常時表示せず、ホバーと押下の表示を明確にしました。
- 半透明の配色を調整: パネル、メニュー項目、操作ボタン、選択状態の背景と細い枠線を整えました。Topic セレクターは白い背景を保ち、グレーの切り替えスイッチと区別します。
- 進行状況を見やすく: リーダー、本のカード、詳細画面で既読・未読の配色を統一しました。リーダーのつまみを 22 × 10 px に広げ、上下の操作バーには均一な半透明背景と細い区切り線を使用します。
- サムネイルの選択範囲: 画像とページ番号を一つの範囲として扱い、上・左右のハイライト余白を揃えてホバー・選択表示を改善しました。
- 複数冊のカスタム並べ替え: ドラッグ中は表紙とタイトルだけのコンパクトなカードを扇状に表示します。選択数を示し、ポインターからの位置を安定させました。
- バックグラウンド読み込み: ランダムアクセスを確認できた非ソリッド圧縮元では、ページとサムネイルの準備を制限付きで並列実行し、表示中の内容を優先します。素早い移動や終了で古くなった要求を取り下げ、以前の結果が再表示されるのを防ぎます。ソリッド圧縮、アクセス能力が不明な圧縮元、PDF は従来の直列準備を維持します。
- 使い方の文書: 中国語・日本語の完全なマニュアルを追加し、タグ作成と各 OS の保存先を明確にしました。
- Windows の文字配置: ベースライン間隔が行全体の高さより短い場合に、省略表示ラベルの高さが 1 px 足りなくなる問題を修正しました。パネルや操作部を拡大せずに、文字に必要な高さを確保します。
- 画像形式の互換性: 古い Qt でネイティブコーデックを読み込めない場合は、既存の Pillow でバックグラウンドのデコードと事前縮小を行います。Ubuntu ARM64 の WebP 読書、サムネイル、表紙プレビューを修正しました。
ダウンロードとインストール
ページ下部の Assets(添付ファイル) から、お使いの OS に合うパッケージを選んでください:
| OS | パッケージ | 要件 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+、Intel 版なし |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
Ubuntu 22.04 でビルド |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
Ubuntu 22.04 でビルド |
SHA256SUMS はパッケージのチェックサム、build-info.json はバージョン、実際のビルドコミット、各環境のビルド情報です。Linux 版はすべてのディストリビューションとの互換性を保証しません。
macOS の初回起動: DMG を開き、JoyRead をアプリケーションへドラッグして、そこから起動します。ad-hoc 署名を使用し、Apple の公証は受けていません。確認できないアプリという警告が出た場合、入手元を確認したうえで:
- **「完了」**をクリックします。「ゴミ箱に入れる」は選びません。
- アップルメニュー → システム設定 → プライバシーとセキュリティを開きます。
- **「セキュリティ」**で JoyRead のブロック通知を探します。
- **「このまま開く」**をクリックし、必要に応じて確認・認証します。
新しいコピーでは再承認が必要になることがあります。Launchpad に見当たらない場合は、アプリケーションフォルダから直接開いてください。
Windows: EXE インストーラーを実行します。信頼されたコード署名がないため、SmartScreen が表示された場合は入手元を確認して**「詳細情報 → 実行」**を選びます。
Ubuntu: ダウンロード先でターミナルを開き、アーキテクチャに合うコマンドを実行します。GUI インストーラーは「準備中」で停止する場合があるため、APT を使用してください:
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.1-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.1-linux-arm64.deb更新と互換性
1.3.0 からの更新では新しいデータベース移行はありません。蔵書、コレクション、タグ、カスタム順序、表紙、読書位置、本ごとの設定を保持します。更新前の蔵書バックアップを推奨します。先読みは引き続き前 4/後 8 ページが初期値です。Windows のバックグラウンドモードと待機中の自動メモリ解放も初期設定で有効です。ZIP/CBZ、7z/CB7、RAR/CBR、PDF に対応し、EPUB は引き続き無効です。
検証
4 対象ではビルド 38928032902で出荷構成をテストしてからパッケージを作成しました。固定のソースコミットは 4847ff1ddecf0bb8281670b6741c7ab8f28145c1、Python は 3.12.9 です。EPUB のゲートは無効のままです。
| 対象 | テスト成功 | スキップ | パッケージの状況 |
|---|---|---|---|
| macOS arm64 | 2024 | 12 | DMG ビルド成功 |
| Windows x64 | 2015 | 21 | EXE ビルド成功 |
| Linux amd64 | 2026 | 10 | DEB ビルド成功 |
| Linux arm64 | 2026 | 10 | DEB ビルド成功 |
Ubuntu の両パッケージは APT インストール、独立した蔵書での起動、WebP Reader の初回フレームのスモークテストを通過しました。amd64 の 289 個、arm64 の 288 個の ELF ファイルは、すべて glibc ≤ 2.35 を満たします。4 パッケージのバージョン、アーキテクチャ、完全なビルドコミット、SHA-256 を照合済みです。対象ごとのビルド情報は build-info.json に保持しています。
独立した回帰 CIも 5 ジョブすべて成功し、Ubuntu 24.04 と macOS の EPUB 追加依存関係構成も確認しました。ローカルでの最終 125% オフスクリーン UI・画像処理の検証は 145 テスト成功です。これらの自動検証はデスクトップの手動確認を代替しません。
手動確認:2026-10-20 に、メンテナーが macOS・Windows・Ubuntu の全環境でテスト成功を確認しました。 CI はオフスクリーン環境で実行し、デスクトップの手動確認とは別に記録します。1.3.1 を安定版として公開します。
既知の制限
非常に大きなプログレッシブ JPEG のページでは、デコード中にプロセスのメモリ使用量が大きくなる場合があります。事前縮小とキャッシュ予算は機能しており、追加のメモリ最適化は優先度の低い今後の項目です。
ジョイヨミは GPL-3.0-only で提供されます。
JoyRead 1.3.1
A clearer reading interface and smoother page preparation. JoyRead 1.3.1 refines Detail and navigation panels, progress indicators, and multi-book drag previews, and improves background loading for random-access archives.
What's improved
- Detail and Topic panels: fixed title/close rows, refined toolbar spacing, and more room for Detail content. Close buttons keep a borderless resting state with clearer hover and pressed feedback.
- Balanced translucent surfaces: refined backgrounds and thin borders for panels, menu items, action buttons, and selection states. The Topic selector retains its white background, distinct from gray switches.
- Clearer reading progress: matching read/unread colors across the Reader, book cards, and Detail. The Reader handle is now 22 × 10 px; top and bottom controls use uniform translucent backgrounds with subtle separators.
- Thumbnail selection: images and page numbers share one selection area, with aligned top/left/right highlight insets and more consistent hover and selected states.
- Multi-book custom sorting: compact cover/title cards form a fan while dragging, with a selection count and a stable pointer offset.
- Background loading: confirmed random-access, non-solid sources use bounded concurrent page and thumbnail preparation, favoring visible content. Rapid navigation and closing retire obsolete requests so stale results cannot reappear. Solid archives, unknown-access sources, and PDFs retain their existing serial preparation policy.
- Documentation: complete Chinese and Japanese manuals, with clearer tag-creation instructions and platform-specific storage paths.
- Windows text layout: elided labels retain a full font line box when baseline spacing is shorter, preventing a one-pixel shortfall without enlarging panels or controls.
- Image-format compatibility: when an older Qt build cannot load a native codec, existing Pillow codecs decode and pre-scale in workers, restoring Ubuntu ARM64 WebP reading, thumbnails, and cover previews.
Download and install
Choose the package for your platform from Assets at the bottom of this page:
| Platform | Installer | Requirements |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+; no Intel build |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
Built on Ubuntu 22.04 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
Built on Ubuntu 22.04 |
SHA256SUMS contains installer checksums; build-info.json records the version, actual build commit, and per-targe...
JoyRead v1.3.0
English (default) · 展开查看完整中文说明 · 日本語の全文は下を展開してください。
简体中文 · 欣阅 1.3.0
更快回到阅读,更顺手地打开书籍。欣阅 1.3.0 带来启动体验优化、默认阅读偏好,以及更完善的全屏和适应宽度阅读。
Windows 专属:再次启动加速
隆重推出 Windows 专属功能:再次启动加速。
关闭窗口,下一次阅读仍然随时就绪。新的后台模式让欣阅保留在系统托盘中,再次打开书库或通过资源管理器打开漫画、PDF 时,可复用正在运行的进程,减少重复启动的等待。
- 关闭窗口,保持就绪: 后台模式默认开启。首次关闭最后一个窗口时,可选择「保持运行」或「退出欣阅」。在设置 → 通用中可关闭后台模式,恢复关闭最后一个窗口即退出。
- 从托盘继续阅读: 重新打开书库,选择漫画或 PDF 直接阅读、无需导入,查看当前内存占用,手动清理内存缓存,或彻底退出。
- 自动清理闲置内存: 默认在所有窗口关闭 60 秒后清理可重建的内存缓存;若仍有后台任务,则等待任务完成。延迟可设为 1–3600 秒,也可关闭自动清理。此功能不会设置 Windows 登录自启动。
其他更新
- 更轻快的启动: 从系统「打开方式」打开文件时直接进入阅读器,无需先加载书库。正常启动时先显示书库窗口,书籍在后台载入,设置和直接打开书籍仍可使用。
- 打开与导入更清晰: 直接打开文件不会复制或入库;「打开并导入」可边读边导入,并支持取消。拖到书库「阅读」区域时是否同时导入,可单独设置。
- 默认阅读偏好: 在设置中预设阅读方向、布局等选项,用于临时打开的文件和未保存独立阅读设置的书籍;已有书籍偏好继续保留。
- 全屏与长页阅读: 按 F 进入全屏,Esc 退出;全屏时页面与阅读器边缘使用直角。横向阅读的「适应宽度」支持滚轮、触控板和 ↑ / ↓ 上下移动,长按可连续移动;到页边停止,左右翻页后从新页顶部开始。调整窗口或切换全屏时尽量保留阅读位置。
- 更稳定的书库切换: 独立打开的外部书籍在切换书库时继续阅读;依赖旧书库的阅读器会先保存再关闭。改善加载失败后的重试,减少调整窗口和无关设置时的重复加载。
- 界面细节优化: 改善 Windows 窗口前台激活与菜单边缘,补齐中日文字体 Medium 字重,并让不可用的从属设置统一变灰。
下载与安装
在本页底部的 Assets(附件) 中选择安装包:
| 系统 | 安装包 | 要求 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.0-macos-arm64.dmg |
macOS 13+,不提供 Intel 版本 |
| Windows · x64 | JoyRead-1.3.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.0-linux-amd64.deb |
基于 Ubuntu 22.04 构建 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.0-linux-arm64.deb |
基于 Ubuntu 22.04 构建 |
SHA256SUMS 提供安装包校验值;build-info.json 记录版本、源代码提交与各平台构建来源。Linux 包并不保证兼容所有发行版。
macOS 首次启动指南: 打开 DMG,把 JoyRead 拖进应用程序文件夹,再从该文件夹启动。应用使用 ad-hoc 签名,尚未经过 Apple 公证。如果系统提示无法验证应用,在确认下载来源后:
- 点击**「完成」**,不要点击「移到废纸篓」。
- 打开苹果菜单 → 系统设置 → 隐私与安全性。
- 在**「安全性」**中找到 JoyRead 被阻止的提示。
- 点击**「仍要打开」**,按提示确认或验证身份。
安装新副本后可能需要再次确认。如果 Launchpad 尚未显示,请先从「应用程序」直接打开。
Windows: 运行 EXE 安装程序。安装包没有受信任的代码签名;如果出现 SmartScreen 提示,确认来源后选择**「更多信息 → 仍要运行」**。
Ubuntu: 在下载目录打开终端,按架构选择命令。图形安装器仍可能卡在“正在准备”,请使用 APT:
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.0-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.0-linux-arm64.deb升级与兼容性
从 1.2.0 升级不新增数据库迁移,保留书库、合集、标签、自定义排序、封面和阅读进度,以及已有的逐书阅读设置。建议升级前备份书库。Windows 后台模式及闲置内存自动清理默认开启,可在通用设置中调整。支持 ZIP/CBZ、7z/CB7、RAR/CBR 和 PDF,EPUB 仍未启用。
欣阅使用 GPL-3.0-only 许可证。
日本語 · ジョイヨミ 1.3.0
すばやく読書に戻り、もっと手軽に本を開く。ジョイヨミ 1.3.0 では、起動の改善、既定の読書設定、全画面表示と幅に合わせた表示の操作を追加しました。
Windows 限定:2 回目以降の起動を高速化
Windows 限定の新機能として、2 回目以降の起動高速化をご紹介します。
ウィンドウを閉じても、次の読書に備えて待機します。新しいバックグラウンドモードでは通知領域に常駐し、ライブラリを再び開く場合や、エクスプローラーから漫画・PDF を開く場合に、実行中のプロセスを再利用して起動の待ち時間を減らします。
- 閉じても待機: 初期設定で有効です。最後のウィンドウを初めて閉じる際に、実行を続けるかジョイヨミを終了するかを選べます。設定 → 一般で無効にすると、最後のウィンドウを閉じた時点で終了します。
- トレイから読書を再開: ライブラリを開く、漫画や PDF を取り込まずに読む、現在のメモリ使用量を確認する、メモリキャッシュを手動で解放する、完全に終了する操作ができます。
- 待機中のメモリを自動解放: 初期設定では、すべてのウィンドウを閉じてから 60 秒後に再生成可能なメモリキャッシュを解放します。バックグラウンド処理が残っている場合は完了を待ちます。待機時間は 1–3600 秒に変更でき、自動解放を無効にもできます。Windows ログイン時の自動起動は設定しません。
その他の更新
- 軽快な起動: OS の「プログラムから開く」ではライブラリを先に読み込まず、直接リーダーを開きます。通常起動ではライブラリのウィンドウを先に表示して本をバックグラウンドで読み込み、その間も設定や本を直接開く操作が使えます。
- 開く操作と取り込みを整理: 直接開くだけではファイルをコピーしたり蔵書へ追加したりしません。「開いて取り込む」では読みながら取り込め、取り込みをキャンセルできます。ライブラリの「読む」領域へのドロップ時に取り込むかどうかも個別に設定できます。
- 既定の読書設定: 読む方向やレイアウトなどを設定画面で指定し、一時的に開いたファイルや個別設定のない本に適用できます。保存済みの本ごとの設定は維持されます。
- 全画面表示と縦長ページ: F で全画面に入り、Esc で戻ります。全画面ではページとリーダーの外周を角丸なしで表示します。横方向の読書で「幅に合わせる」を選ぶと、ホイール、トラックパッド、↑ / ↓ で上下に移動でき、キーの長押しにも対応します。ページ端で止まり、左右キーでページをめくると新しいページの先頭から表示します。サイズ変更や全画面の切り替え時も、可能な範囲で読書位置を維持します。
- ライブラリ切り替えを安定化: 独立して開いた外部ファイルは切り替え中も読み続けられます。元のライブラリに依存するリーダーは保存してから閉じます。読み込み失敗時の再試行を改善し、サイズ変更や無関係な設定変更による重複読み込みを減らしました。
- UI の調整: Windows でのウィンドウの前面表示とメニューの縁を改善し、中国語・日本語フォントの Medium ウェイトを追加しました。無効な従属設定は一貫してグレー表示になります。
ダウンロードとインストール
ページ下部の Assets(添付ファイル) から選んでください:
| OS | パッケージ | 要件 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.0-macos-arm64.dmg |
macOS 13+、Intel 版なし |
| Windows · x64 | JoyRead-1.3.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.0-linux-amd64.deb |
Ubuntu 22.04 でビルド |
| Ubuntu / Linux · arm64 | JoyRead-1.3.0-linux-arm64.deb |
Ubuntu 22.04 でビルド |
SHA256SUMS はパッケージのチェックサム、build-info.json はバージョン、ソースコミット、各環境のビルド情報です。Linux 版はすべてのディストリビューションとの互換性を保証しません。
macOS の初回起動: DMG を開き、JoyRead をアプリケーションへドラッグして、そこから起動します。ad-hoc 署名を使用し、Apple の公証は受けていません。確認できないアプリという警告が出た場合、入手元を確認したうえで:
- **「完了」**をクリックします。「ゴミ箱に入れる」は選びません。
- アップルメニュー → システム設定 → プライバシーとセキュリティを開きます。
- **「セキュリティ」**で JoyRead のブロック通知を探します。
- **「このまま開く」**をクリックし、必要に応じて確認・認証します。
新しいコピーでは再承認が必要になることがあります。Launchpad に見当たらない場合は、アプリケーションフォルダから直接開いてください。
Windows: EXE インストーラーを実行します。信頼されたコード署名がないため、SmartScreen が表示された場合は入手元を確認して**「詳細情報 → 実行」**を選びます。
Ubuntu: ダウンロード先でターミナルを開き、アーキテクチャに合うコマンドを実行します。GUI インストーラーは「準備中」で停止する場合があるため、APT を使用してください:
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.0-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.0-linux-arm64.deb更新と互換性
1.2.0 からの更新では新しいデータベース移行はありません。蔵書、コレクション、タグ、カスタム順序、表紙、読書位置、本ごとの設定を保持します。更新前の蔵書バックアップを推奨します。Windows のバックグラウンドモードと待機中のメモリ自動解放は初期設定で有効で、一般設定から変更できます。ZIP/CBZ、7z/CB7、RAR/CBR、PDF に対応し、EPUB は引き続き無効です。
ジョイヨミは GPL-3.0-only で提供されます。
JoyRead 1.3.0
Get back to reading faster. JoyRead 1.3.0 brings a smoother startup experience, default reading preferences, and better fullscreen and fit-to-width reading.
Windows exclusive: faster subsequent launches
Proudly introducing a Windows exclusive: faster subsequent launches.
Close the window. Stay ready for your next read. The new background mode keeps JoyRead in the notification area, reusing the running process when you reopen the Library or open a comic or PDF from Explorer, so there is less startup work to wait for.
- Close and stay ready: background mode is enabled by default. The first time you close the last window, choose Keep running or Quit JoyRead. Disable it in Settings → General to exit when the last window closes.
- Pick up from the tray: reopen the Library, choose a comic or PDF to read without importing, view current memory usage, clear memory caches, or quit completely.
- Automatic idle cleanup: by default, rebuildable memory caches are cleared 60 seconds after all windows close, waiting for any remaining background work to finish. Set the delay to 1–3600 seconds or disable automatic cleanup. This feature does not enable startup at Windows sign-in.
What's new across platforms
- A lighter startup: opening a file through your system's Open With goes straight to its Reader without loading the Library first. A normal launch shows the Library window before loading books in the background; settings and direct book opening remain available.
- Clearer open and import choices: opening a file in place does not copy it or add it to your Library. Open & Import lets you read while a cancellable import runs. A separate preference controls whether dropping a file onto the Library's Read zone also imports it.
- Default reading preferences: choose reading direction, layout, and other defaults for temporary files and books without saved individual settings. Existing per-book preferences remain in place.
- Fullscreen and tall-page reading: press F for fullscreen and Esc to leave, with square page and reader edges in fullscreen. In horizontal Fit to Width, use the wheel, trackpad, or ↑ / ↓ to move vertically; hold an arrow to keep moving. Scrolling stops at page edges, while left/right page turns start the new page at the top. Resizing or switching fullscreen preserves your position where page bounds allow.
- More reliable Library switching: independently opened external books stay usable while switching libraries. Readers tied to the old Library save before closing. Recovery retries use the selected Library, and window resizing or unrelated settings changes avoid unnecessary reloads.
- UI refinements: improved Windows foreground activation and menu edges, bundled Medium-weight Chinese/Japanese fonts, and consistent dimming of unavailable dependent settings.
Download and install
Choose a package from Assets below:
| Platform | Installer | Requirements |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.0-macos-arm64.dmg |
macOS 13+; no Intel build |
| Windows · x64 | JoyRead-1.3.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.0-linux-amd64.deb |
Built on Ubuntu 22.04 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.0-linux-arm64.deb |
Built on Ubuntu 22.04 |
SHA256SUMS contains installer checksums; build-info.json records the version, source commit, and per-target provenance. Linux packages do not imply compatibility with every distribution.
macOS first launch: open the DMG, drag JoyRead into Applications, and launch it there. The app is ad-hoc signed and not Apple-notarized. If macOS says it cannot verify the app, after verifying your download source:
- Click Done, not Move to Bin.
- Open Apple menu → System Settings → Privacy & Security.
- Find the JoyRead blocked-app notice under Security.
- Click Open Anyway, then confirm/authenticate as prompted.
A new copy may require approval again. If Launchpad does not show it, open it directly from Applications first.
Windows: run the EXE installer. It has no trusted code signature; if SmartScreen appears, verify the source before choosing **Mo...
JoyRead v1.2.0
English (default) · 展开查看完整中文说明 · 日本語の全文は下を展開してください。
简体中文 · 欣阅 1.2.0
预览再跳页,让阅读更顺手;书库和设置也更适合不同窗口大小。
本次更新
- 进度条缩略图预览: 鼠标悬停 180 ms 后显示,拖动滑块时立即显示。气泡上方为缩略图,下方为从 1 开始的页码,以 80% 不透明度展示;靠近窗口边缘时自动避让。缺少图片时显示紧凑的加载提示,图片到达后展开。离开进度条后用 320 ms 淡出,期间返回会立即恢复。
- 预览不打断阅读: 松手才跳页;Esc、按住左键时右击、窗口失活或在窗口外松手均可取消。页面加载完成不会把正在拖动的滑块拉回原处。预览与阅读器 Topic 面板共用缩略图缓存;快速移动只保留最新待处理目标。固实或无法确认随机访问能力的压缩源只使用已有缓存,不因预览主动解压。
- 可调预加载: 阅读设置新增全局预加载窗口,默认前 4 页、后 8 页,分别可设为 0–10 和 0–20;0 关闭该侧后台预读。设置立即同步所有阅读器并在重启后保留。修正从右向左阅读时的预读方向偏置,以及双页模式的边界计算。
- 更流畅的缩略图: 详情页和 Topic 面板随滚动调整加载优先级,优先处理可见页,复用已有图片和控件,减少重复解码。详情页、Topic 面板和封面选择器统一显示页码,点击图片或页码均可选页。
- 菜单自动避让: 书籍、合集、书签及下拉菜单根据窗口内的空间调整展开方向;过长菜单可滚动,窄菜单提供省略文字的完整提示。
- 窗口大小记忆: 分别保存书库和独立阅读器的窗口大小,通用设置可恢复默认大小。小屏幕按可用空间调整窗口,保留最小尺寸,并让标题栏靠近屏幕左上角。
- 紧凑布局与侧栏: 搜索框展开时自适应宽度并保留筛选;设置行放不下时将控制区移至文字下方。书架和合集管理区可独立收起/展开并记忆状态,标题支持鼠标及 Enter/空格操作,按压反馈与切换闪烁得到改善。
- 鼠标交互修复: 修复选书后手形指针和悬停状态残留。点击书架工具栏的标题或空白处可清除选择,Shift、搜索框和按钮仍保留原有操作。
下载与安装
在本页底部的 Assets(附件) 中选择安装包:
| 系统 | 安装包 | 要求 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.2.0-macos-arm64.dmg |
macOS 13+,不提供 Intel 版本 |
| Windows · x64 | JoyRead-1.2.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.2.0-linux-amd64.deb |
基于 Ubuntu 22.04 构建 |
| Ubuntu / Linux · arm64 | JoyRead-1.2.0-linux-arm64.deb |
基于 Ubuntu 22.04 构建 |
SHA256SUMS 提供安装包校验值;build-info.json 记录版本、源代码提交与各平台构建来源。Linux 包并不保证兼容所有发行版。
macOS 首次启动指南(沿用 1.0.1): 打开 DMG,把 JoyRead 拖进应用程序文件夹,再从该文件夹启动。应用使用 ad-hoc 签名,尚未经过 Apple 公证。如果系统提示无法验证应用,在确认下载来源后:
- 点击**「完成」**,不要点击「移到废纸篓」。
- 打开苹果菜单 → 系统设置 → 隐私与安全性。
- 在**「安全性」**中找到 JoyRead 被阻止的提示。
- 点击**「仍要打开」**,按提示确认或验证身份。
安装新副本后可能需要再次确认。如果 Launchpad 尚未显示,请先从「应用程序」直接打开。
Windows: 运行 EXE 安装程序。安装包没有受信任的代码签名;如果出现 SmartScreen 提示,确认来源后选择**「更多信息 → 仍要运行」**。
Ubuntu: 在下载目录打开终端,按架构选择命令。图形安装器仍可能卡在“正在准备”,请使用 APT:
# amd64 / x86-64
sudo apt install ./JoyRead-1.2.0-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.2.0-linux-arm64.deb升级与兼容性
从 1.1.0 升级不新增数据库迁移,保留书库、自定义排序、封面裁剪和阅读进度;新增预加载设置默认为前 4/后 8。建议升级前备份书库。支持 ZIP/CBZ、7z/CB7、RAR/CBR 和 PDF,EPUB 仍未启用。
验证
维护者已完成桌面验收。四份安装包均由构建 35311131525从同一提交 20eabf1616eda690a293b1640adb3b89ef04a8ee 生成,测试和打包全部成功。
| 平台 | 测试通过 | 跳过 | 安装包 |
|---|---|---|---|
| macOS arm64 | 1754 | 12 | DMG |
| Windows x64 | 1745 | 21 | EXE |
| Linux amd64 | 1756 | 10 | DEB |
| Linux arm64 | 1756 | 10 | DEB |
两个 Linux 架构还通过了 APT 安装和安装后程序验证。发布流程核对全部安装包的 SHA-256,并在正式发布前再次验证上传后的文件摘要。附件包含合并校验表与逐平台构建来源。
欣阅使用 GPL-3.0-only 许可证。
日本語 · ジョイヨミ 1.2.0
移動先を確認してからページへ。読書をより快適にし、ライブラリと設定画面もさまざまなウィンドウサイズに対応しました。
更新内容
- 進行バーのサムネイルプレビュー: ポインターを 180 ms 重ねると表示し、スライダーをドラッグすると即座に表示します。吹き出しの上に画像、下に 1 から始まるページ番号を配置し、不透明度 80% で表示します。ウィンドウ端では位置を調整します。画像がない間は小さな読み込み表示になり、画像が届くと展開します。バーから離れると 320 ms でフェードアウトし、その間に戻ると即座に復帰します。
- 読書を妨げないプレビュー: ボタンを離すまでページは移動しません。Esc、左ボタンを押したまま右クリック、ウィンドウの非アクティブ化、ウィンドウ外でのボタン解放でキャンセルできます。ページの読み込み完了でドラッグ中の位置が戻ることもありません。リーダーの Topic パネルとサムネイルキャッシュを共有し、素早く移動した際は最新の待機対象だけを保持します。ソリッド圧縮やランダムアクセス可否が不明な圧縮元では、既存キャッシュのみを使い、プレビューのために展開しません。
- 先読み範囲を設定: 読書設定に共通の先読み設定を追加しました。初期値は前 4 ページ/後 8 ページで、前は 0–10、後は 0–20 に設定できます。0 はその側のバックグラウンド先読みを無効にします。開いている全リーダーに反映し、再起動後も保持します。右から左へ読む際の先読み方向と、見開きの境界計算を修正しました。
- 滑らかなサムネイル表示: 詳細画面と Topic パネルでスクロールに合わせて読み込み順を更新し、表示中のページを優先します。画像とウィジェットを再利用し、重複デコードを減らしました。詳細画面、Topic パネル、表紙選択画面でページ番号を表示し、画像と番号のどちらからも選択できます。
- メニューの自動配置: 本、コレクション、しおりのメニューやドロップダウンがウィンドウ内の空きに応じて開く方向を変えます。長いメニューはスクロールでき、狭い場合は省略された文字列をツールチップで確認できます。
- ウィンドウサイズを記憶: ライブラリと独立したリーダーのサイズを別々に保存し、一般設定から初期サイズへ戻せます。小さな画面では最小サイズを維持しつつ利用可能な領域に合わせ、タイトルバーを画面左上に配置します。
- 狭い画面とサイドバーを改善: 展開した検索欄が幅に合わせて縮み、フィルターを維持します。設定行に収まらない操作部はラベルの下へ移動します。本棚とコレクションは個別に折りたため、状態を保存します。見出しはマウスと Enter/スペースに対応し、押下表示と切り替え時のちらつきを改善しました。
- マウス操作を修正: 本を選んだ後に手形カーソルやホバー状態が残る問題を修正しました。本棚ツールバーのタイトルや空白をクリックすると選択が解除され、Shift、検索入力、ボタンの操作は維持されます。
ダウンロードとインストール
ページ下部の Assets(添付ファイル) から選んでください:
| OS | パッケージ | 要件 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.2.0-macos-arm64.dmg |
macOS 13+、Intel 版なし |
| Windows · x64 | JoyRead-1.2.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.2.0-linux-amd64.deb |
Ubuntu 22.04 でビルド |
| Ubuntu / Linux · arm64 | JoyRead-1.2.0-linux-arm64.deb |
Ubuntu 22.04 でビルド |
SHA256SUMS はパッケージのチェックサム、build-info.json はバージョン、ソースコミット、各環境のビルド情報です。Linux 版はすべてのディストリビューションとの互換性を保証しません。
macOS の初回起動(1.0.1 の手順を継承): DMG を開き、JoyRead をアプリケーションへドラッグして、そこから起動します。ad-hoc 署名を使用し、Apple の公証は受けていません。確認できないアプリという警告が出た場合、入手元を確認したうえで:
- **「完了」**をクリックします。「ゴミ箱に入れる」は選びません。
- アップルメニュー → システム設定 → プライバシーとセキュリティを開きます。
- **「セキュリティ」**で JoyRead のブロック通知を探します。
- **「このまま開く」**をクリックし、必要に応じて確認・認証します。
新しいコピーでは再承認が必要になることがあります。Launchpad に見当たらない場合は、アプリケーションフォルダから直接開いてください。
Windows: EXE インストーラーを実行します。信頼されたコード署名がないため、SmartScreen が表示された場合は入手元を確認して**「詳細情報 → 実行」**を選びます。
Ubuntu: ダウンロード先でターミナルを開き、アーキテクチャに合うコマンドを実行します。GUI インストーラーは「準備中」で停止する場合があるため、APT を使用してください:
# amd64 / x86-64
sudo apt install ./JoyRead-1.2.0-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.2.0-linux-arm64.deb更新と互換性
1.1.0 からの更新では新しいデータベース移行はありません。蔵書、カスタム順序、編集した表紙、読書位置を保持し、新しい先読み設定は前 4/後 8 で始まります。更新前の蔵書バックアップを推奨します。ZIP/CBZ、7z/CB7、RAR/CBR、PDF に対応し、EPUB は引き続き無効です。
検証
メンテナーによるデスクトップでの受け入れ確認は完了しています。4 つのパッケージはビルド 35311131525で同じコミット 20eabf1616eda690a293b1640adb3b89ef04a8ee から生成し、すべてのテストとパッケージ作成に成功しました。
| 対象 | テスト成功 | スキップ | パッケージ |
|---|---|---|---|
| macOS arm64 | 1754 | 12 | DMG |
| Windows x64 | 1745 | 21 | EXE |
| Linux amd64 | 1756 | 10 | DEB |
| Linux arm64 | 1756 | 10 | DEB |
Linux の両アーキテクチャでは APT インストールとインストール後のアプリ検証も通過しました。公開処理では全パッケージの SHA-256 を照合し、正式公開前にアップロード後のダイジェストも確認します。添付ファイルに統合チェックサムと各環境のビルド情報を含めています。
ジョイヨミは GPL-3.0-only で提供されます。
JoyRead 1.2.0
Preview before you jump. Read more comfortably, with a library and settings that fit your window.
What's new
- Progress-bar thumbnail previews: hover for 180 ms or start dragging for an immediate preview. The bubble shows an image above its 1-based page number at 80% opacity and adjusts at window edges. Missing images use a compact Loading message that expands when the image arrives. Leaving fades it out over 320 ms; returning during the fade restores it immediately.
- Preview without interrupting reading: release to jump. Esc, right-click while holding left, window deactivation, or releasing outside the window cancels. Page-load completion no longer pulls an active slider back. Previews share Topic's thumbnail cache and retain only the latest waiting target during fast movement. Solid or unknown-access archive sources use existing caches without triggering extraction for previews.
- Adjustable preloading: global Reader settings default to 4 previous and 8 following pages, adjustable to 0–10 and 0–20. Zero disables background preloading on that side. Changes synchronize across open readers and survive restart. Fixes cover right-to-left prefetch bias and double-page boundaries.
- Smoother thumbnails: Detail and Topic reprioritize loading as you scroll, favor visible pages, reuse images and widgets, and reduce duplicate decoding. Detail, Topic, and the cover picker now show page numbers; either the image or its number selects the page.
- Menus that fit: book, collection, bookmark, and dropdown menus adjust their opening direction to the available window space. Tall menus scroll; narrow menus expose elided text through full tooltips.
- Remembered window sizes: Library and independent Reader sizes are saved separately, with a General settings button to restore defaults. Small screens fit the available area while respecting minimum dimensions and positioning the title bar at the top-left.
- Compact layouts and sidebar sections: expanded search adapts its width while retaining filters. Settings controls move below labels when a row is too narrow. Bookshelf and Collections collapse independently and remember their state. Headers support mouse and Enter/Space, with improved pressed feedback and less flicker.
- Mouse interaction fixes: selecting a book no longer leaves a stale hand cursor or hover state. Clicking the shelf toolbar title or blank space clears selection while preserving Shift, search, and button behavior.
Download and install
Choose a package from Assets below:
| Platform | Installer | Requirements |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.2.0-macos-arm64.dmg |
macOS 13+; no Intel build |
| Windows · x64 | JoyRead-1.2.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.2.0-linux-amd64.deb |
Built on Ubuntu 22.04 |
| Ubuntu / Linux · arm64 | JoyRead-1.2.0-linux-arm64.deb |
Built on Ubuntu 22.04 |
SHA256SUMS contains installer checksums; build-info.json records the version, source commit, and per-target provenance. Linux packages do not imply compatibility with every distribution.
macOS first launch (carried forward from 1.0.1): open the DMG, drag JoyRead into Applications, and launch it there. The app is ad-hoc signed and not Apple-notarized. If macOS says it cannot verify the app, after verifying your download source:
- Click Done, not Move to Bin.
- Open Apple menu → System Settings → Privacy & Security.
- Find the JoyRead blocked-app notice unde...
JoyRead 1.1.0
JoyRead 1.1.0
Custom shelf ordering, smoother interaction, and sharper HiDPI thumbnails.
English
What's new
- Custom shelf order: All, Favourites, Hidden Space and individual collections
remember their own order and sort preference. New members appear at the front;
Recent keeps reading-time order. Search and filters preserve saved positions. - Selection and dragging: grid and list both support rectangle selection.
Shift-click toggles selection; Shift-drag selects even when started on a book.
Drag without Shift to reorder in unfiltered Custom mode. Selected books move
in their displayed order, with one insertion placeholder and up to three
preview cards. Esc, right-click while holding left, or release outside cancels. - Smoother interaction: reuse cards and rows, update only changed content,
cache blurred snapshots, and smoothly blend the file-drop confirmation state.
Disabled switches show neither side selected. - Sharper thumbnails: bookshelf covers, Detail thumbnails and Reader Topic
thumbnails follow window pixel density. Display changes preserve selection,
scroll/reading position and existing images while replacements load. - Drag previews use 40% card size and a 5 px pointer gap. Auto-scroll activates
only in the top/bottom 15% of the shelf, reaching 120 px/s at the edge.
Upgrade and testing notes
- This release adds database migration 14 for scoped sorting. Back up the
library before upgrading; restore the backup if returning to the older release. - Existing custom cover crops remain authoritative. Old low-resolution custom
covers need to be saved again from their original source for native sharpness. - EPUB remains disabled. Supported manga/archive/PDF workflows remain in scope.
- Native Windows/Ubuntu gesture behavior, physical mixed-DPI monitor moves,
and installer upgrade/uninstall checks remain pending for this release. - macOS remains Apple Silicon only. Existing signing/notarization and Linux
graphical-installer limitations from 1.0.2 still apply.
简体中文
v1.1.0:自定义排序、更顺滑的交互和更清晰的 HiDPI 缩略图。
- 自定义排序: 全部、收藏、隐藏空间及各合集独立记忆顺序与排序偏好;新增项前置,最近阅读仍按阅读时间排列。
- 框选与多选拖动: 网格和列表均支持。Shift 单击切换选中,Shift 拖动从卡片上也能框选;不按 Shift 时可在无筛选的自定义模式中拖动排序。移动组保持原显示顺序。
- 交互更顺滑: 复用卡片与列表行,差量更新内容;模糊快照缓存,确认动画平滑过渡;禁用 switch 两侧均不突出选中。
- HiDPI: 封面、详情页及 Reader Topic 内页缩略图随窗口像素密度生成;跨屏刷新保留选择、滚动位置与阅读位置。
- 拖动预览为卡片的 40%,指针间距 5 px;仅上下各 15% 区域自动滚动,边缘最高 120 px/s。Esc、按住左键时右击、区域外松手均可取消。
本版会升级书库到数据库迁移 14,升级前请备份书库,回退旧版时恢复备份。
旧的低清手工裁剪封面需从原图重新保存。EPUB 继续禁用。
Windows/Ubuntu 原生拖动、实机跨屏及安装升级/卸载仍待验证;1.0.2 已有的签名、公证和 Linux 图形安装器限制仍适用。
日本語
v1.1.0:カスタム順序、滑らかな操作、鮮明な HiDPI サムネイル。
- カスタム順序: すべて、お気に入り、非表示スペース、各コレクションで順序と並び替え設定を個別に保存。追加した本は先頭に入り、最近読んだ本は読書日時順を維持します。
- 範囲選択と複数ドラッグ: グリッド/リストに対応。Shift クリックで選択を切り替え、Shift ドラッグは本の上からでも範囲選択。検索やフィルターを解除したカスタム順序では、Shift を離してドラッグすると表示順を保って移動します。
- 滑らかな表示: カード/行を再利用して差分更新し、ぼかし画像をキャッシュ。ファイルドロップの確認状態へ滑らかに移行します。無効なスイッチでは選択側を強調しません。
- HiDPI: 表紙、詳細パネル、Reader Topic のサムネイルがウィンドウのピクセル密度に対応。画面間移動でも選択・スクロール・読書位置を保持します。
- ドラッグ表示は 40%、ポインターから 5 px。自動スクロールは上下 15% の範囲で動作し、端では最大 120 px/s。Esc、左ボタンを押しながら右クリック、領域外で離す操作でキャンセルできます。
データベース移行 14 を適用するため、更新前に蔵書をバックアップしてください。
旧版へ戻す際はバックアップを復元します。低解像度の編集済み表紙は元画像から再保存してください。
EPUB は引き続き無効です。Windows/Ubuntu の実機操作、異なる DPI の画面間移動、インストール更新/削除の検証は未完了です。1.0.2 の署名・公証・Linux GUI インストーラーに関する制限も引き続き適用されます。
Download and install / 下载与安装 / ダウンロードとインストール
Choose an installer from Assets below. SHA256SUMS lists all installer
checksums; build-info.json records their exact source commit and CI build.
| Platform | Installer | Requirements |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.1.0-macos-arm64.dmg |
macOS 13+; no Intel build |
| Windows · x64 | JoyRead-1.1.0-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.1.0-linux-amd64.deb |
Built on Ubuntu 22.04 |
| Ubuntu / Linux · arm64 | JoyRead-1.1.0-linux-arm64.deb |
Built on Ubuntu 22.04 |
macOS installation — English
These are the first-launch instructions carried forward from v1.0.1.
Open the DMG and drag JoyRead into Applications. Launch JoyRead from there.
The app is ad-hoc signed and not Apple-notarized. If macOS says Apple could
not verify that JoyRead is free of malware, and you have verified the download
source:
- Click Done, not Move to Bin.
- Open Apple menu → System Settings → Privacy & Security.
- Scroll to Security and find the JoyRead blocked-app notice.
- Click Open Anyway, then confirm/authenticate when prompted.
A newly installed copy may require this approval again. If it is missing from
Launchpad, first try opening it directly from Applications.
macOS 安装指南 — 简体中文
沿用 v1.0.1 的首次启动指南:打开 DMG,把 JoyRead 拖进应用程序文件夹,再从该文件夹启动。
应用使用 ad-hoc 签名,尚未经过 Apple 公证。如果提示 Apple 无法验证 JoyRead 是否包含恶意软件,在确认下载来源后:
- 在提示框点**「完成」**,不要点「移到废纸篓」。
- 打开苹果菜单 → 系统设置 → 隐私与安全性。
- 向下找到**「安全性」**中的 JoyRead 被阻止提示。
- 点击**「仍要打开」**,按系统提示确认或验证身份。
安装新副本后可能需要再次确认。如果 Launchpad 暂时没有显示,请先从「应用程序」文件夹打开一次。
macOS のインストール — 日本語
v1.0.1 の初回起動手順を引き継いでいます。DMG を開き、JoyRead をアプリケーションへドラッグして、そこから起動してください。
ad-hoc 署名を使用しており、Apple の公証は受けていません。Apple がマルウェアの有無を確認できないという警告が出た場合、入手元を確認したうえで:
- **「完了」**をクリックします。「ゴミ箱に入れる」は選ばないでください。
- アップルメニュー → システム設定 → プライバシーとセキュリティを開きます。
- **「セキュリティ」**にある JoyRead のブロック通知を探します。
- **「このまま開く」**をクリックし、必要に応じて確認・認証します。
新しいコピーのインストール後は再承認が必要になることがあります。Launchpad に見当たらない場合は、まずアプリケーションフォルダから直接起動してください。
Windows / Ubuntu
Windows: run the EXE installer. If SmartScreen warns, verify the source before
choosing More info → Run anyway / 更多信息 → 仍要运行 / 詳細情報 → 実行.
Ubuntu: use APT, not the graphical installer, which may remain at “Preparing”.
Choose the command matching your architecture:
# amd64 / x86-64
sudo apt install ./JoyRead-1.1.0-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.1.0-linux-arm64.deb中文:Ubuntu 请在终端使用对应架构的 APT 命令安装,图形安装器仍可能卡在“正在准备”。
日本語:Ubuntu では対応するアーキテクチャの APT コマンドを使用してください。GUI インストーラーは「準備中」で停止することがあります。
Validation / 验证状态 / 検証状況
All four installers were built from 7a737a7652c82f1d095e65f890cc45fedf4e96d8
in Build packages #35171639415.
| Target | Passed | Skipped | Package |
|---|---|---|---|
| macos-arm64 | 1643 | 12 | DMG built successfully |
| windows-x86_64 | 1634 | 21 | EXE built successfully |
| linux-amd64 | 1645 | 10 | DEB built successfully |
| linux-arm64 | 1645 | 10 | DEB built successfully |
Both Linux architectures also passed APT installation and installed-application
verification. Installer checksums and source metadata accompany the assets.
These are automated/offscreen checks. Native mouse capture, physical mixed-DPI
monitor moves, and manual installer upgrade/uninstall acceptance remain pending.
中文:四个平台测试与安装包构建均成功,两个 Linux 架构还通过了 APT 安装及安装后程序验证。
这些属于自动/离屏检查,不等于完整实机验收;原生鼠标捕获、实机跨屏和手动升级/卸载仍待验证。
日本語:全ターゲットでテストとパッケージ作成が成功し、Linux の両アーキテクチャでは APT インストールとインストール後の起動検証も通過しました。
自動・オフスクリーン検証であり、実機のマウスキャプチャ、異なる DPI の画面間移動、手動更新・削除の検証は未完了です。
JoyRead 1.0.2
English (default) · Expand 中文 or 日本語 below.
简体中文 · 欣阅 1.0.2
让本地书籍管理更加便捷,也是随时打开、即时阅读的选择。
Linux 兼容性重建 · 2026-09-13
Linux amd64 / arm64 安装包已在 Ubuntu 22.04 重建,Debian 包版本为 1.0.2-1,应用版本仍是 1.0.2。修复 ARM64 Shiboken 对较新 glibc 的要求及 C++ 运行库冲突,并调整 Qt 6.8 下封面编辑器的信号生命周期。原先下载过 Linux 包的用户请重新下载,再通过下方 APT 命令升级。
两个架构各有 1557 项测试通过、10 项跳过,并通过 APT 安装、所有打包 ELF 的 glibc ≤ 2.35 检查及安装后程序启动验证。macOS / Windows 安装包保持原样。图形安装器的 “Preparing” 问题仍未修复。
本次更新
- 更完整的三语体验: 新配置默认跟随系统语言,支持英文、简体中文和日文,不支持的语言回退到英文;升级保留已有的明确语言选择。
- 本地化应用名称: 界面中显示欣阅 / JoyRead / ジョイヨミ,安装包名称和数据路径保持 JoyRead。
- 即时切换语言: 更新已打开的窗口、菜单和对话框,同时保留输入内容、阅读状态与后台任务;补齐隐藏空间、恢复界面、标签操作和阅读器提示等翻译。
- 归档与缓存修复: 改进缓存占用管理、归档暂存和资源清理。
- 存储修复: 重置书库前等待 SQLite 完全释放,修复 Windows 下数据库关闭与重置竞争的问题。
- 打包改进: 提供 macOS arm64、Windows x64、Linux amd64 / arm64 安装包;修复 Windows UTF-8 测试与 Miniforge libffi 打包兼容性。
下载与安装
在页面底部 Assets 下载:macOS 使用 .dmg(拖入 Applications),Windows 使用 -setup.exe,Ubuntu 使用对应架构的 .deb(必须在终端运行 sudo apt install ./文件名.deb 安装,将文件名替换为实际下载的名称)。SHA256SUMS 提供完整性校验,build-info.json 记录构建来源。
Ubuntu 图形安装器会卡在 “Preparing”,此问题尚未修复;请仅通过命令行安装。 在下载目录打开终端后运行上述命令。
macOS 13+ 仅提供 Apple Silicon 包,未经 Apple 公证;若系统阻止启动,可在确认下载来源后使用系统设置 → 隐私与安全性 → 仍要打开。Windows 安装程序无受信任的代码签名,SmartScreen 可能提示;确认来源后可选择“更多信息 → 仍要运行”。Linux 包在 Ubuntu 22.04 构建,不代表所有发行版均兼容。
阅读与书库
支持 ZIP/CBZ、7z/CB7、RAR/CBR 和 PDF;提供拖放阅读或导入、系统可选打开方式、卡片/列表切换、标签、书单与隐藏空间。详情页双击书名、作者或语言可调整信息,双击封面可进入编辑器。导入包中的受支持 meta.json / ComicInfo.xml 可用于预填书名、作者、标签与语言。
加密漫画可读但不可导入;隐藏仅作用于 GUI,不加密文件。 解密后的页面缓存是明文,默认在关闭书籍时删除。7z、RAR、ZipCrypto ZIP 的辅助进程命令行可能短暂暴露密码;AES ZIP 使用进程内解密。EPUB 尚未启用;solid RAR 性能仍未实测。
验证状态
四个平台 CI 测试与安装包构建均成功:macOS 1553 通过 / 11 跳过,Windows 1544 / 20,重建后的 Linux 两种架构均 1557 / 10。它们是离屏测试,不等于实机桌面验证。本版本的新安装、升级/卸载、系统打开方式、多窗口语言切换、原生对话框及 Ubuntu Wayland/X11 验证仍待完成。
日本語 · ジョイヨミ 1.0.2
ローカルの蔵書管理をもっと手軽に。読みたいときに、すぐ読める。
Linux 互換性のための再ビルド · 2026-09-13
Linux amd64 / arm64 パッケージを Ubuntu 22.04 で再ビルドしました。Debian パッケージは 1.0.2-1、アプリのバージョンは 1.0.2 のままです。ARM64 Shiboken の glibc 要求と C++ ランタイムの競合を解消し、Qt 6.8 での表紙エディターのシグナル寿命を修正しました。以前の Linux パッケージをご利用の場合は、再ダウンロードして下の APT コマンドで更新してください。
両アーキテクチャでそれぞれ 1557 件成功・10 件スキップ。APT インストール、全 ELF の glibc ≤ 2.35 検査、インストール済みアプリの起動を確認しました。macOS / Windows パッケージは変更していません。GUI インストーラーの「Preparing」問題は未修正です。
更新内容
- 3 言語の使いやすさを改善: 新規設定ではシステム言語に従い、英語・簡体字中国語・日本語に対応。未対応言語では英語を使用し、アップグレード時は明示的な言語設定を保持します。
- アプリ内の名称をローカライズ: 欣阅 / JoyRead / ジョイヨミを表示。インストーラー名とデータパスは JoyRead のままです。
- 開いている画面にも言語変更を反映: ウィンドウ、メニュー、ダイアログを更新し、入力内容、読書状態、バックグラウンド処理を保持。非表示スペース、復旧画面、タグ操作、リーダーのメッセージなどの翻訳を補完しました。
- アーカイブとキャッシュを修正: キャッシュの使用権管理、作業用ファイル、リソース解放を改善しました。
- ストレージを修正: ライブラリのリセット前に SQLite の解放を待ち、Windows での終了処理との競合を修正しました。
- パッケージの改善: macOS arm64、Windows x64、Linux amd64 / arm64 向けに提供。Windows の UTF-8 テストと Miniforge libffi の同梱処理を修正しました。
ダウンロードとインストール
下の Assets から、macOS は .dmg(Applications にドラッグ)、Windows は -setup.exe、Ubuntu は対応するアーキテクチャの .deb を選んでください。DEB はターミナルで sudo apt install ./ファイル名.deb を実行してインストールしてください(実際にダウンロードしたファイル名に置き換えてください)。SHA256SUMS は整合性確認用、build-info.json はビルド情報です。
Ubuntu の GUI インストーラーは「Preparing」で停止します。この問題は未修正のため、ターミナルからのみインストールしてください。 ダウンロード先のフォルダーで上記のコマンドを実行します。
macOS 13+ は Apple Silicon のみで、Apple の公証は受けていません。起動がブロックされた場合、配布元を確認したうえでシステム設定 → プライバシーとセキュリティから開くことができます。Windows 版には信頼されたコード署名がなく、SmartScreen が表示される場合があります。配布元を確認して「詳細情報 → 実行」を選べます。Linux 版は Ubuntu 22.04 でビルドしており、すべてのディストリビューションへの互換性を保証するものではありません。
読書とライブラリ
ZIP/CBZ、7z/CB7、RAR/CBR、PDF に対応。ドラッグ&ドロップで読む・取り込む、OS の「このアプリで開く」、カード/リスト表示、タグ、コレクション、非表示スペースを使えます。詳細画面でタイトル・著者・言語をダブルクリックして変更し、表紙のダブルクリックで編集できます。対応する meta.json / ComicInfo.xml を含む漫画は、取り込み時にタイトル・著者・タグ・言語を反映できます。
暗号化された漫画は読めますが、インポートはできません。非表示は GUI 上の機能で、ファイルは暗号化しません。 復号したページキャッシュは平文で保存し、初期設定では本を閉じると削除します。7z、RAR、ZipCrypto ZIP では補助プロセスのコマンドラインにパスワードが一時的に現れる場合があります。AES ZIP はアプリ内で復号します。EPUB は未有効化で、solid RAR の性能は未検証です。
検証状況
4 環境で CI テストとパッケージ作成に成功しました。macOS は 1553 件成功 / 11 件スキップ、Windows は 1544 / 20、再ビルドした Linux は両アーキテクチャとも 1557 / 10 です。これらはオフスクリーンテストであり、実機デスクトップ検証の代わりにはなりません。新規インストール、更新・アンインストール、OS からのファイル起動、複数ウィンドウでの言語変更、ネイティブダイアログ、Ubuntu Wayland/X11 の確認は未完了です。
JoyRead 1.0.2
Your local library, easier to manage. Your next book, ready to read.
Linux compatibility rebuild · 2026-09-13
The Linux amd64 and arm64 installers have been rebuilt on Ubuntu 22.04. Their Debian package version is 1.0.2-1; the application remains 1.0.2. This fixes ARM64 Shiboken's newer-glibc requirement and a C++ runtime mismatch, with a small cover-editor signal lifetime fix for Qt 6.8. If you downloaded an earlier Linux installer, download it again and use the APT command below to upgrade.
Each architecture passed 1557 tests (10 skipped), APT installation, a check that every bundled ELF requires glibc ≤ 2.35, and startup of the installed executable with an isolated library. macOS and Windows assets are unchanged. The graphical installer's Preparing issue remains unresolved.
What's new
- A more complete three-language experience. New profiles follow the system language across macOS, Windows, and Ubuntu/Linux, choosing English, Simplified Chinese, or Japanese with English fallback. Existing explicit language choices survive upgrades.
- Localized in-app names: 欣阅 / JoyRead / ジョイヨミ. Installer names, application identity, and data paths stay JoyRead.
- Live language switching updates open windows, menus, and dialogs while preserving input, reading state, and background tasks. Translation fixes cover Hidden Space, recovery screens, tag operations, reader prompts, and tooltips. Chinese/Japanese Qt widget translations are bundled.
- Archive and cache fixes improve cache ownership, staging, and resource cleanup.
- Safer library resets wait for SQLite to release its files, fixing a shutdown/reset race on Windows.
- Packaging improvements cover macOS arm64, Windows x64, and Linux amd64/arm64, including Windows UTF-8 tests and Miniforge libffi compatibility.
Downloads
Choose a package from Assets below:
| System | File | Install |
|---|---|---|
| macOS 13+ · Apple Silicon | JoyRead-1.0.2-macos-arm64.dmg |
Open and drag JoyRead into Applications. |
| Windows · x64 | JoyRead-1.0.2-windows-x86_64-setup.exe |
Run the installer. |
| Ubuntu/Linux · amd64 | JoyRead-1.0.2-linux-amd64.deb |
sudo apt install ./JoyRead-1.0.2-linux-amd64.deb |
| Ubuntu/Linux · arm64 | JoyRead-1.0.2-linux-arm64.deb |
sudo apt install ./JoyRead-1.0.2-linux-arm64.deb |
Ubuntu: install from the terminal only. The graphical installer gets stuck at “Preparing”; this issue has not been fixed. Open a terminal in the download folder and run the command for your package above.
SHA256SUMS contains the installer checksums. build-info.json records version, source commit, target, and Python version. Linux packages were built on Ubuntu 22.04; compatibility with every Linux distribution is not implied. Intel Mac packages are not provided.
First launch: the macOS build is ad-hoc signed but not Apple-notarized. If blocked, verify the download source and use System Settings → Privacy & Security → Open Anyway. Windows installers have no trusted code signature; SmartScreen may appear. After verifying the source, use More info → Run anyway if offered.
Read now, organise for later
Read ZIP/CBZ, 7z/CB7, RAR/CBR, and PDF. Drag a book onto Read to open it immediately or Import to keep a managed copy. JoyRead can also be selected through your OS's Open With integration. Switch between cards and lists, organise tags and collections, and keep selected books out of the ordinary shelf with Hidden Space.
In book details, double-click the title, author, or language to adjust it, or double-click the cover to edit it. Supported embedded meta.json / ComicInfo.xml metadata can populate the title, author, tags, and language during import.
Illustrated introduction · User manual
Known limitations
- Encrypted comics are readable but cannot be imported. Passwords are used for the current reading session only.
- Hidden Space only hides content in the GUI; it does not encrypt files.
- Decrypted page caches are plaintext. Delete cached pages when closing is enabled by default. For 7z, RAR, and legacy ZipCrypto ZIP, helper command-line passwords may be briefly visible to same-user processes. AES ZIP is decrypted in-process.
- EPUB / light novel reading remains disabled. Solid-RAR performance remains unverified.
- Native desktop validation for this version remains pending: fresh installation, upgrade/uninstall, OS file activation, language switching across multiple windows, native dialogs, and Ubuntu Wayland/X11 behavior.
Build and validation
macOS and Windows retain source commit 88ff97e2e386ab749f5a024ab65fe1c7f662f826 from run 34670838470. Linux installers use ab9e82cf5cd4f39530758d642f9e59c709dfa5d9 from Ubuntu 22.04 rebuild 34746301590. All use Python 3.12.9. Per-target provenance and the updated checksums are included in Assets; the original release tag is retained.
| CI target | Tests passed | Skipped | Package |
|---|---|---|---|
| macOS arm64 | 1553 | 11 | Success |
| Windows x64 | 1544 | 20 | Success |
| Linux amd64 | 1557 | 10 | Success |
| Linux arm64 | 1557 | 10 | Success |
These runs test the shipping configuration with EPUB dependencies absent and Qt in offscreen mode. They...
JoyRead 1.0.1
JoyRead 1.0.1 makes window management behave on all three platforms, and is the
first release with native installers for Windows and Ubuntu/Debian.
macOS users on 1.0.0 should update: dragging a maximized window was unreliable
there in several distinct ways, all fixed here.
日本語 — ダウンロードとインストール
どのファイルを選ぶか
| プラットフォーム | ファイル | 動作環境 |
|---|---|---|
| macOS(Apple シリコン) | JoyRead-1.0.1-macos-arm64.dmg |
macOS 13 以降。Intel 版はありません。 |
| Windows(64ビット) | JoyRead-1.0.1-windows-x86_64-setup.exe |
Windows 10 / 11、x86-64 |
| Ubuntu / Debian(64ビット) | JoyRead-1.0.1-linux-amd64.deb |
Ubuntu 22.04 以降、x86-64 |
いずれのビルドにもコード署名がありません。初回起動時に必ず警告が出ます。
macOS
.dmg を開き、JoyRead を「アプリケーション」フォルダにドラッグしてください。
初回起動はブロックされます。「"JoyRead" は開けませんでした ―― "JoyRead"
にマルウェアが含まれていないことを Apple は確認できませんでした」と表示されます。
これは想定どおりの動作です。JoyRead は Apple の公証(notarization)を受けて
おらず ad-hoc 署名のため、Apple 側に照合できる情報がありません。次の手順で
一度だけ許可してください。
- 表示されたメッセージで 「完了」(Done) をクリックします。「ゴミ箱に入れる」は選ばないでください。
- アップルメニュー →「システム設定」 を開きます。
- サイドバーで 「プライバシーとセキュリティ」 を選びます。
- 下の方の 「セキュリティ」 までスクロールすると、JoyRead がブロックされた旨の表示があります。
- 「このまま開く」(Open Anyway) をクリックし、確認を求められたら承認します。
この操作はインストールごとに一度だけで済みます。
一度「アプリケーション」フォルダから起動するまで Launchpad に表示されない
ことがありますが、原因は同じで、初回起動後は解消します。
Windows
インストーラーを実行してください。署名がないため SmartScreen の警告
(「Windows によって PC が保護されました」)が表示されます。続行する場合は
「詳細情報」→「実行」 を選びます。
Ubuntu / Debian
sudo apt install ./JoyRead-1.0.1-linux-amd64.debUbuntu 22.04 では .deb をダブルクリックしないでください。 Ubuntu
Software(snap 版)はローカルパッケージをインストールできず、「準備中…」の
まま止まります。上記のコマンドを使えば、依存関係は APT が解決します。
アンインストールは sudo apt remove joyread です。
简体中文 — 下载与安装
该下载哪一个
| 平台 | 文件 | 系统要求 |
|---|---|---|
| macOS(Apple 芯片) | JoyRead-1.0.1-macos-arm64.dmg |
macOS 13 或更高。没有 Intel 版本。 |
| Windows(64 位) | JoyRead-1.0.1-windows-x86_64-setup.exe |
Windows 10 / 11,x86-64 |
| Ubuntu / Debian(64 位) | JoyRead-1.0.1-linux-amd64.deb |
Ubuntu 22.04 或更高,x86-64 |
三个版本都没有代码签名,首次启动时都会有安全提示。
macOS
打开 .dmg,把 JoyRead 拖进「应用程序」文件夹。首次启动会被拦截,提示
「未打开"JoyRead"—— Apple 无法验证"JoyRead"是否包含可能危害 Mac 或泄露隐私的
恶意软件」。
这是预期内的。JoyRead 使用 ad-hoc 签名,没有经过 Apple 公证,所以 Apple 那边
没有可校验的记录。按下面的步骤放行一次即可:
- 在提示框中点 「完成」(Done)。不要点「移到废纸篓」。
- 打开 苹果菜单 →「系统设置」。
- 在侧边栏选择 「隐私与安全性」。
- 向下滚动到 「安全性」,会看到 JoyRead 被阻止的提示。
- 点击 「仍要打开」(Open Anyway),如果系统要求确认就确认。
每次安装只需要做一次。
另外,在从「应用程序」文件夹成功打开一次之前,Launchpad 里可能找不到
JoyRead——原因相同,首次启动之后就正常了。
Windows
运行安装程序。由于没有签名,SmartScreen 会弹出警告(「Windows 已保护你的
电脑」)。如果确认继续,点 「更多信息」→「仍要运行」。
Ubuntu / Debian
sudo apt install ./JoyRead-1.0.1-linux-amd64.deb在 Ubuntu 22.04 上不要双击 .deb 文件。 Ubuntu Software(snap 版)无法
安装本地软件包,会一直卡在「正在准备…」。请使用上面的命令,依赖由 APT 解决。
卸载:sudo apt remove joyread。
Which file do I want?
| Platform | Download | Requires |
|---|---|---|
| macOS (Apple Silicon) | JoyRead-1.0.1-macos-arm64.dmg |
macOS 13 or later. No Intel build. |
| Windows (64-bit) | JoyRead-1.0.1-windows-x86_64-setup.exe |
Windows 10 or 11, x86-64 |
| Ubuntu / Debian (64-bit) | JoyRead-1.0.1-linux-amd64.deb |
Ubuntu 22.04 or later, x86-64 |
None of these is code-signed. Every platform will warn you the first time.
That is expected for this release, and each section below says exactly what
you will see and what to do about it.
Installing
macOS
Open the .dmg and drag JoyRead to Applications. The first launch will be
blocked, with "JoyRead" Not Opened — Apple could not verify "JoyRead" is free
of malware that may harm your Mac or compromise your privacy.
That is expected. JoyRead is signed ad-hoc rather than notarised by Apple, so
Apple has nothing to check it against. Allow it once:
- Click Done on that message. Do not click Move to Bin.
- Open the Apple menu → System Settings.
- Click Privacy & Security in the sidebar.
- Scroll to Security near the bottom. You will see
"JoyRead" was blocked to protect your Mac. - Click Open Anyway, and confirm if macOS asks.
You only need to do this once per install.
You may also find JoyRead missing from Launchpad until you have opened it once
from the Applications folder — same cause, and it resolves after the first
successful launch.
Windows
Run the installer. SmartScreen will warn you with "Windows protected your
PC", because the installer is unsigned. Choose More info → Run anyway if
you are happy to proceed.
The installer is built with Inno Setup and replaces the MSI used during
development. It registers JoyRead for CBZ, CBR, CB7, ZIP, RAR, 7Z and PDF
without displacing whatever already handles them.
Ubuntu / Debian
sudo apt install ./JoyRead-1.0.1-linux-amd64.debDo not double-click the .deb on Ubuntu 22.04. The Ubuntu Software snap
cannot install local packages and will hang at "Preparing…". Use the command
above; APT resolves the dependencies.
Installs to /opt/joyread with a desktop entry, icon, and MIME associations for
CBZ, CBR, CB7, ZIP, RAR, 7Z and PDF. Installing never replaces an existing
default handler.
To remove: sudo apt remove joyread.
What's fixed
Window management
- A click on the title bar no longer un-maximizes the window before a drag has
begun, which also restores double-click-to-zoom. - Dragging a maximized window on macOS no longer flickers, stalls, or jumps away
from the point you grabbed. - Linux and Windows now let the window manager place a restored window, instead
of racing it with a second client-side placement. - A tiled window you have since resized keeps that size when you next drag it,
rather than snapping back to a stale remembered size. - The Library no longer collapses to a single column with the sidebar and the
vertical scrollbar both open.
Packaging and performance
- Native
.deband Windows installers, as above. - The Linux launcher no longer appears twice in application menus.
- Faster packaged startup and resource loading.
Maintenance
- Removed the development-only Windows/Linux title-control preview from
Settings. Each platform's production window controls are unchanged. - Removed the development JSON-manifest picker from the import menu. Manifest
import remains available to scripts and internal tooling.
Known limitations
- Nothing here is code-signed, as above.
- EPUB reading exists in the codebase but is disabled; the novel reader is not
finished. - Pages extracted from encrypted archives are cached unencrypted. Settings →
Privacy → "Delete cached pages when closing" is on by default, so they do not
outlive the session. - Archive passwords are passed to the bundled 7-Zip executable on its command
line, so they are readable by other processes running as you during
extraction. This affects 7z, RAR, and ZIP using the legacy ZipCrypto cipher.
AES-encrypted ZIP is not affected — it is decrypted in-process. - Solid-RAR performance is unverified; no solid RAR sample was available, so the
7z thread policy is applied to RAR by extrapolation.
Documentation
JoyRead 1.0.0
A fast, local-first desktop reader and library manager for manga, comics, and
PDFs. No accounts, no cloud, no telemetry — your books stay on your machine.
⚠️ First launch — macOS will say JoyRead is damaged
It isn't. This build carries an ad-hoc signature rather than an Apple
Developer ID certificate, and macOS shows that same message for any app it
cannot check with Apple.
After dragging JoyRead to your Applications folder, run this once in Terminal:
xattr -d com.apple.quarantine /Applications/JoyRead.appThen open it normally — you only need to do this once. The disk image repeats
these instructions in English, 日本語, and 简体中文.
Because the app is unsigned, it may also not appear under Apps/Launchpad until
you have opened it once from the Applications folder.
Requirements
macOS 13 or later, Apple Silicon. Windows and Linux are not published yet.
Reading
- ZIP/CBZ, 7z/CB7, RAR/CBR, and PDF
- Single- and two-page spreads with automatic spread detection
- Fit modes, reading direction including right-to-left, page transitions
- Bookmarks, table of contents, thumbnail navigation
- Per-book resume and reader settings
Library
- Import into a managed library, or open files in place
- Collections, tags, favourites, reading history
- Cover thumbnails with a cover editor
- Search, sort, filter
- Hidden Space for books kept off the main shelf
- The library folder can be moved, re-pointed, or reset
Performance
- Expensive archives (solid 7z, RAR, encrypted) are converted once in the
background into a shared extraction pool. On a 124 MB solid 7z this moved
page-turn p95 from 355 ms to 58 ms. - The bundled 7-Zip helper is the primary 7z read path, which moved
page-prepare p95 on that sample from ~1410 ms to ~300 ms. - PDF pages render asynchronously, so decoding never stalls the UI.
- Page, thumbnail, and extraction-pool budgets are all configurable.
Known limitations
- EPUB is not enabled. The novel reader is in the codebase but switched off
until it is finished. - Pages from encrypted archives are cached unencrypted. Settings → Privacy →
"Delete cached pages when closing" is on by default. - Archive passwords are visible to same-user processes during extraction,
for 7z, RAR, and ZIP using the legacy ZipCrypto cipher. AES-encrypted ZIP is
decrypted in-process and unaffected. - RAR is read-only, and by the terms of the bundled unRAR code JoyRead's RAR
support may not be used to build a RAR-compatible archiver. - Solid-RAR performance is unverified.
Documentation
Verifying your download
SHA-256 215778ddf4949c8866d171d114d8f931915372565c33c246a8cb7018ca664fa0
JoyRead is free software under the GNU GPL v3.0.
It redistributes Qt/PySide6, 7-Zip, and Pillow under their own licenses.