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 側に照合できる情報がありません。次の手順で
一度だけ許可してください。

1. 表示されたメッセージで 「完了」（Done） をクリックします。「ゴミ箱に入れる」は選ばないでください。
2. アップルメニュー →「システム設定」 を開きます。
3. サイドバーで 「プライバシーとセキュリティ」 を選びます。
4. 下の方の 「セキュリティ」 までスクロールすると、JoyRead がブロックされた旨の表示があります。
5. 「このまま開く」（Open Anyway） をクリックし、確認を求められたら承認します。

この操作はインストールごとに一度だけで済みます。

一度「アプリケーション」フォルダから起動するまで Launchpad に表示されない
ことがありますが、原因は同じで、初回起動後は解消します。

Windows

インストーラーを実行してください。署名がないため SmartScreen の警告
（「Windows によって PC が保護されました」）が表示されます。続行する場合は
「詳細情報」→「実行」 を選びます。

Ubuntu / Debian

sudo apt install ./JoyRead-1.0.1-linux-amd64.deb

Ubuntu 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 那边
没有可校验的记录。按下面的步骤放行一次即可：

1. 在提示框中点 「完成」（Done）。不要点「移到废纸篓」。
2. 打开 苹果菜单 →「系统设置」。
3. 在侧边栏选择 「隐私与安全性」。
4. 向下滚动到 「安全性」，会看到 JoyRead 被阻止的提示。
5. 点击 「仍要打开」（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:

1. Click Done on that message. Do not click Move to Bin.
2. Open the Apple menu → System Settings.
3. Click Privacy & Security in the sidebar.
4. Scroll to Security near the bottom. You will see
   "JoyRead" was blocked to protect your Mac.
5. 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.deb

Do 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 .deb and 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

• User manual
• Changelog
• Packaging notes