Skip to content

Releases

KOReader for Switch — v0.3.3 (exit-after-reading crash fix)

Choose a tag to compare

@miikearthur miikearthur released this 16 Sep 10:31

Fixes the crash when exiting KOReader after opening a book.

  • Exit-after-reading crash fixed. Closing the app while a document was open could crash with doccache.lua:72: attempt to compare number with nil. On exit KOReader saves its page cache and sorts the entries by access time, but on the Switch a cache file that had already been evicted reports a nil time, which crashed the sort — and took the whole app down. Now handled safely, so exiting after reading is clean. (Verified in the emulator: the exact failing case now succeeds.)

Includes everything from v0.3.2: baked-in fast downloads and night-mode original colours for comics, plus the best-effort HOME-menu exit guards and shutdown logging.

Still a vibe-coded experiment — a fun proof of concept, no warranty, no support.

Downloads

  • …​.nro — homebrew app (Homebrew Menu)
  • …​.nsp — installable title (needs sigpatches)
  • SHA256SUMS

KOReader for Switch — v0.3.2 (baked-in fixes + exit-crash attempt)

Choose a tag to compare

@miikearthur miikearthur released this 15 Sep 23:32

Bakes in the download-speed and night-mode fixes, and takes a first pass at the exit crash.

  • Fast downloads, built in. Large downloads (e.g. comics) no longer crawl — the network read block size is bumped so transfers aren't throttled by the console's networking (measured ~0.5 MB/s → ~5 MB/s).
  • Night mode keeps comics/PDF pages in their real colours. Previously an opened CBZ/PDF looked like a photo negative in night mode; now the page shows true colours while the UI stays dark (covers already behaved this way).
  • Exit crash when closing from the HOME menu — best-effort fix. Closing KOReader from the Switch HOME menu could show "The software was closed because an error occurred." This build skips the display/applet teardown steps that can fault once the system has already asked the app to close, and adds detailed shutdown logging. If it still happens, /switch/koreader/crash.log will now show exactly which step failed. Exiting from KOReader's own menu was always clean and is unchanged.

If you were using the 2-faster-downloads.lua and 2-nightmode-original-pages.lua user patches, you can delete them from /switch/koreader/patches/ after updating — they're built in now (leaving them does no harm).

Includes everything from v0.3.x and v0.2.0. Still a vibe-coded experiment — a fun proof of concept, no warranty, no support.

Downloads

  • …​.nro — homebrew app (Homebrew Menu)
  • …​.nsp — installable title (needs sigpatches)
  • SHA256SUMS

KOReader for Switch — v0.3.1 (faster downloads)

Choose a tag to compare

@miikearthur miikearthur released this 15 Sep 21:21

Experimental: faster downloads on real hardware.

  • Larger TCP socket buffers. The port was using libnx's default (small ~64 KiB receive buffer), which throttled large downloads — a 200 MB CBZ crawled at ~0.4 MB/s. This bumps the receive window to 1 MiB with more buffers per socket. Small files were always fine; this targets big ones (e.g. comics).

Note: on the Switch, a download still runs in the foreground (Horizon doesn't allow the background worker the plugin uses elsewhere), so during a big transfer the app is unresponsive until it finishes — just let it run.

Includes everything from v0.3.0: the rename/atomic-save fix (downloads via plugins like BookOrbit now record correctly), night-mode fix, auto-rotation, touch-only UI, self-install, clean exit to HOME, plugins, and internet.

Still a vibe-coded experiment — a fun proof of concept, no warranty, no support.

Downloads

  • …​.nro — homebrew app (Homebrew Menu)
  • …​.nsp — installable title (needs sigpatches)
  • SHA256SUMS

KOReader for Switch — v0.3.0 (download/rename fix)

Choose a tag to compare

@miikearthur miikearthur released this 15 Sep 20:40

Fixes file downloads through plugins (e.g. BookOrbit) and plugin/settings saving.

  • rename() now replaces an existing file. Horizon's filesystem refused to overwrite an existing file, but POSIX rename() (which KOReader and its plugins rely on for atomic saves — write a temp file, then rename it over the real one) is supposed to replace it. This broke:
    • Downloading a book that the plugin then records to its local state — the transfer succeeded but the bookkeeping rename failed, so the download errored out. This is why larger CBZ downloads (fetched after the plugin's state file already existed) failed while an early EPUB went through.
    • Plugin sync/state saving (e.g. BookOrbit's repeated bookorbit_sync_state.lua: File exists errors).
    • KOReader's own settings saves that overwrite an existing file.

Includes everything from v0.2.0: night-mode fix, accelerometer auto-rotation, touch-only UI, self-install, clean exit to HOME, user plugins, and internet.

Runs on a real Switch. Still a vibe-coded experiment — a fun proof of concept, no warranty, no support.

Downloads

  • …​.nro — homebrew app (Homebrew Menu)
  • …​.nsp — installable title (needs sigpatches)
  • SHA256SUMS

KOReader for Switch — v0.2.0 (auto-rotation + night-mode fix)

Choose a tag to compare

@miikearthur miikearthur released this 15 Sep 19:04

Adds accelerometer auto-rotation, fixes the default orientation, and fixes night mode.

  • Night mode now works properly: it inverts the whole screen (looks great on the OLED) and no longer shows a blank/unchanged screen or slows the UI to a crawl. Toggle it from Settings → Night mode.
  • Boots in the panel's native landscape, upright (no more forced 90° shift). Turn the console to read in portrait — the screen follows — or set/lock any orientation from Settings → Rotation.
  • Auto-rotation uses KOReader's native rotation machinery (auto-rotate, lock to current, or ignore the sensor). Only the Switch Lite has a built-in motion sensor; on a regular Switch / OLED the sensor is in the Joy-Con, so auto-rotation needs them attached (manual rotation works everywhere).

Includes everything before it: touch-only UI, self-install, clean exit to HOME, user plugins, and working internet (Wikipedia, OPDS, news, translation).

Runs on a real Switch. Still a vibe-coded experiment — a fun proof of concept, no warranty, no support.

Downloads

  • …​.nro — homebrew app (Homebrew Menu)
  • …​.nsp — installable title (needs sigpatches)
  • SHA256SUMS

KOReader for Switch — v0.1.0 (vibe-coded experiment)

Choose a tag to compare

@miikearthur miikearthur released this 15 Sep 18:17

A completely vibe-coded experiment. I just wanted to see if KOReader could run on the Switch, and had it built end-to-end by an AI assistant. It works in the Ryujinx emulator but has not been tested on real hardware — treat it as a fun proof of concept. No warranty, no support.

Port of KOReader v2026.07.2-161-g945470b. Touch-screen only; hold the console sideways (portrait, like an e-reader).

Downloads

  • koreader-switch-…​.nro — homebrew app, run from the Homebrew Menu.
  • koreader-switch-…​.nsp — installable title (own HOME-menu icon, full memory). Needs sigpatches on the console.
  • SHA256SUMS — checksums.

Both are fixed-key homebrew and contain none of your console keys. See the README for install steps, controls, and build-from-source instructions.

Verified in the Ryujinx emulator

Launch, self-install, document rendering, portrait rotation, touch/menus, file browser, deleting files, clean exit, user-added plugins, and networking (DNS + HTTP + HTTPS).

Not confirmed (needs real hardware)

The SQLite-backed plugins (statistics, cover browser, vocabulary builder, news) don't initialize under the emulator's SD-card emulation; and nothing has been run on an actual console.