Toggle search
Toggle menu
12.2K
15.1K
1.2K
217K
GameBrew
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

WookReader Switch: Difference between revisions

From GameBrew
More actions
Created page with "{{Infobox Switch Homebrews |title=WookReader |image=WookReaderSwitch.png |description=A homebrew comic and ebook reader for the Nintendo Switch. |author=exorevan |lastupdated=2026/05/27 |type=File Browsers |version=0.7.0 |license=GPL-2.0 |download=https://dlhb.gamebrew.org/switchhomebrews/WookReaderSwitch.7z |website=https://github.com/exorevan/WookReader |source=https://github.com/exorevan/WookReader |donation= }} {{#seo: |title=Switch Homebrew Apps (File Browsers) - Ga..."
 
No edit summary
 
(One intermediate revision by one other user not shown)
Line 19: Line 19:
|image_alt=WookReader
|image_alt=WookReader
}}
}}
WookReader is a comic and e-book reader for the Nintendo Switch. It is a fork of eBookReaderSwitch with major improvements to performance, format support, and usability.
WookReader is a comic and e-book reader for the Nintendo Switch. It is a fork of [[eBookReaderSwitch]] with major improvements to performance, format support, and usability.


== Features ==
== Features ==
* Format support - PDF, EPUB, XPS, CBZ, CBR, CBT, CB7.
* Reading modes - Portrait, Landscape, Vertical (fit-to-width), Spread (two-page comics).
* Cover grid browser with folder navigation and thumbnail previews.
* Recently Opened virtual folder at root for quick access to the last 20 books.
* Async prefetch - next/previous pages pre-rendered for instant page turns.
* Raw image LRU cache - revisited pages load instantly.
* Early first-page display - cover shown in ~0.5s while large archives enumerate in background.
* Page-name disk cache - second+ open of any comic skips enumeration entirely.
* RAR3 fast enumeration - header-only scan (~50ms for 500MB solid RAR).
* Progressive navigation - flip through pages while archive is still scanning.
* Analog stick scrolling - full 360° proportional panning with left stick.
* Pinch-to-zoom and right-stick zoom.
* Swipe gestures - swipe to turn pages (direction matches current reading mode).
* Screen navigation buttons - on-screen previous/next overlays, auto-fade after 3 s.
* Pan locking - panning disabled when page fits the screen (no blank-space dragging).
* Notes per book - attach freeform text notes to any book or comic.
* Dark and light mode.
* Natural sort - files sort as 1, 2, 11 (not 1, 11, 2).
* Saves last page, orientation, and dark mode settings.
* Sorted file browser (folders first A-Z, files A-Z, case-insensitive).


* '''Format support:''' PDF, EPUB, XPS, CBZ, CBR, CBT, CB7
== Installation ==
* '''Reading modes:''' Portrait, Landscape, Vertical (fit-to-width), Spread (two-page comics)
Copy <code>WookReader.nro</code> to <code>/switch/WookReader/</code> on the SD card.
* Cover grid browser with folder navigation and thumbnail previews
* Recently Opened virtual folder at root for quick access to the last 20 books
* Async prefetch — next/previous pages pre-rendered for instant page turns
* Raw image LRU cache — revisited pages load instantly
* Early first-page display — cover shown in ~0.5s while large archives enumerate in background
* Page-name disk cache — second+ open of any comic skips enumeration entirely
* RAR3 fast enumeration — header-only scan (~50ms for 500MB solid RAR)
* Progressive navigation — flip through pages while archive is still scanning
* Analog stick scrolling — full 360° proportional panning with left stick
* Pinch-to-zoom and right-stick zoom
* Swipe gestures — swipe to turn pages (direction matches current reading mode)
* Screen navigation buttons — on-screen previous/next overlays, auto-fade after 3 s
* Pan locking — panning disabled when page fits the screen (no blank-space dragging)
* Notes per book — attach freeform text notes to any book or comic
* Dark and light mode
* Natural sort — files sort as 1, 2, 11 (not 1, 11, 2)
* Saves last page, orientation, and dark mode settings
* Sorted file browser (folders first A-Z, files A-Z, case-insensitive)


== Installation ==
Put your comics and books in folders inside <code>/switch/WookReader/</code>.


# Copy <code>WookReader.nro</code> to <code>/switch/WookReader/</code> on the SD card
== User guide ==
# Put your comics and books in folders inside <code>/switch/WookReader/</code>
Open Options from the file browser with the Plus button:
* Scroll Speed - Left-stick and D-pad scroll distance per tick.
* Zoom Amount - Zoom step for ZL/ZR and D-pad zoom actions.
* Dark Mode Off - Invert page colours.
* Status Bar (Default: On) - Show page number and zoom level at bottom of screen.
* Screen Buttons (Default: Off) - On-screen previous/next buttons that fade after 3s.


== Controls ==
== Controls ==
=== Navigation ===
'''Portrait/Vertical:'''
D-Pad Left/Right or ZL/ZR - Prev/Next page
D-Pad Up/Down - Zoom max/out
R+ZR/L+ZL - Skip 9 pages forward/back
SR/SL (Joy-Con) - Skip 10 pages forward/back
Right Stick Up/Down - Zoom in/out
'''Landscape:'''
D-Pad Left/Right or Up/Down - Prev/Next page


=== Navigation ===
Right Stick Up/Down - Prev/Next page
 
ZL/ZR - Zoom out/Zoom in
 
R+ZR/L+ZL - Skip 9 pages forward/back


{| class="wikitable"
SR/SL (Joy-Con) - Skip 10 pages forward/back
! Input !! Portrait / Vertical !! Landscape
|-
| D-Pad Left / Right || Prev / Next page || Prev / Next page
|-
| D-Pad Up || Zoom max || Prev page
|-
| D-Pad Down || Zoom out || Next page
|-
| ZL / ZR || Prev / Next page || Zoom out / Zoom in
|-
| R+ZR / L+ZL || Skip 9 pages forward/back || Skip 9 pages forward/back
|-
| SR / SL (Joy-Con) || Skip 10 pages forward/back || Skip 10 pages forward/back
|-
| Right Stick Up/Down || Zoom in / out || Prev / Next page
|}


=== View ===
=== View ===
Left Stick - Analog scroll 360° (panning disabled when page fits screen)


{| class="wikitable"
Left/Right Stick Click - Reset view (zoom + pan)
! Input !! Action
 
|-
Y - Cycle layout (Portrait > Landscape > Vertical > Portrait)
| Left Stick || Analog scroll 360° (panning disabled when page fits screen)
 
|-
X - Toggle status bar
| Left / Right Stick click || Reset view (zoom + pan)
 
|-
Minus - Toggle dark/light mode
| Y || Cycle layout: Portrait → Landscape → Vertical → Portrait
|-
| X || Toggle status bar
|-
| Minus || Toggle dark / light mode
|}


=== Touch ===
=== Touch ===
'''Portrait/Vertical:'''
Drag (1 finger) - Scroll/pan


{| class="wikitable"
Pinch (2 fingers) - Zoom
! Gesture !! Portrait / Vertical !! Landscape
|-
| Drag (1 finger) || Scroll / pan || Scroll / pan
|-
| Pinch (2 fingers) || Zoom || Zoom
|-
| Swipe left/right (≥180 px) || Next / Prev page || —
|-
| Swipe up/down (≥180 px) || — || Prev / Next page
|-
| Tap left or right edge || Prev / Next page || —
|-
| Tap top or bottom edge || — || Prev / Next page
|}


Screen navigation buttons (if enabled in Options) follow the same left/right ↔ top/bottom axis as the current layout.
Swipe left/right (≥180 px) - Next/Prev page
 
Tap left or right edge - Prev/Next page
 
'''Landscape:'''
 
Drag (1 finger) - Scroll/pan
 
Pinch (2 fingers) - Zoom
 
Swipe up/down (≥180 px) - Prev/Next page
 
Tap top or bottom edge - Prev/Next page
 
Screen navigation buttons (if enabled in Options) follow the same left/right - top/bottom axis as the current layout.


=== Other ===
=== Other ===
A - Go to page (number pad)
L - Open notes overlay for current book
A (notes open) - Edit note via on-screen keyboard
B - Exit notes overlay/exit reader


{| class="wikitable"
Plus - Toggle help overlay
! Input !! Action
|-
| A || Go to page (number pad)
|-
| L || Open notes overlay for current book
|-
| A (notes open) || Edit note via on-screen keyboard
|-
| B || Exit notes overlay / exit reader
|-
| Plus || Toggle help overlay
|}


==Screenshots==
==Screenshots==
{| style=""max-width:80%; margin-left:0em;""
{| style="max-width:80%; margin-left:0em;"
|
|
https://dlhb.gamebrew.org/switchhomebrews/images/WookReaderSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/WookReaderSwitch-01.png

Latest revision as of 07:09, 22 June 2026

WookReader
General
Authorexorevan
TypeFile Browsers
Version0.7.0
LicenseGPL-2.0
Last Updated2026/05/27
Links
Download
Website
Source

WookReader is a comic and e-book reader for the Nintendo Switch. It is a fork of eBookReaderSwitch with major improvements to performance, format support, and usability.

Features

  • Format support - PDF, EPUB, XPS, CBZ, CBR, CBT, CB7.
  • Reading modes - Portrait, Landscape, Vertical (fit-to-width), Spread (two-page comics).
  • Cover grid browser with folder navigation and thumbnail previews.
  • Recently Opened virtual folder at root for quick access to the last 20 books.
  • Async prefetch - next/previous pages pre-rendered for instant page turns.
  • Raw image LRU cache - revisited pages load instantly.
  • Early first-page display - cover shown in ~0.5s while large archives enumerate in background.
  • Page-name disk cache - second+ open of any comic skips enumeration entirely.
  • RAR3 fast enumeration - header-only scan (~50ms for 500MB solid RAR).
  • Progressive navigation - flip through pages while archive is still scanning.
  • Analog stick scrolling - full 360° proportional panning with left stick.
  • Pinch-to-zoom and right-stick zoom.
  • Swipe gestures - swipe to turn pages (direction matches current reading mode).
  • Screen navigation buttons - on-screen previous/next overlays, auto-fade after 3 s.
  • Pan locking - panning disabled when page fits the screen (no blank-space dragging).
  • Notes per book - attach freeform text notes to any book or comic.
  • Dark and light mode.
  • Natural sort - files sort as 1, 2, 11 (not 1, 11, 2).
  • Saves last page, orientation, and dark mode settings.
  • Sorted file browser (folders first A-Z, files A-Z, case-insensitive).

Installation

Copy WookReader.nro to /switch/WookReader/ on the SD card.

Put your comics and books in folders inside /switch/WookReader/.

User guide

Open Options from the file browser with the Plus button:

  • Scroll Speed - Left-stick and D-pad scroll distance per tick.
  • Zoom Amount - Zoom step for ZL/ZR and D-pad zoom actions.
  • Dark Mode Off - Invert page colours.
  • Status Bar (Default: On) - Show page number and zoom level at bottom of screen.
  • Screen Buttons (Default: Off) - On-screen previous/next buttons that fade after 3s.

Controls

Navigation

Portrait/Vertical:

D-Pad Left/Right or ZL/ZR - Prev/Next page

D-Pad Up/Down - Zoom max/out

R+ZR/L+ZL - Skip 9 pages forward/back

SR/SL (Joy-Con) - Skip 10 pages forward/back

Right Stick Up/Down - Zoom in/out

Landscape:

D-Pad Left/Right or Up/Down - Prev/Next page

Right Stick Up/Down - Prev/Next page

ZL/ZR - Zoom out/Zoom in

R+ZR/L+ZL - Skip 9 pages forward/back

SR/SL (Joy-Con) - Skip 10 pages forward/back

View

Left Stick - Analog scroll 360° (panning disabled when page fits screen)

Left/Right Stick Click - Reset view (zoom + pan)

Y - Cycle layout (Portrait > Landscape > Vertical > Portrait)

X - Toggle status bar

Minus - Toggle dark/light mode

Touch

Portrait/Vertical:

Drag (1 finger) - Scroll/pan

Pinch (2 fingers) - Zoom

Swipe left/right (≥180 px) - Next/Prev page

Tap left or right edge - Prev/Next page

Landscape:

Drag (1 finger) - Scroll/pan

Pinch (2 fingers) - Zoom

Swipe up/down (≥180 px) - Prev/Next page

Tap top or bottom edge - Prev/Next page

Screen navigation buttons (if enabled in Options) follow the same left/right - top/bottom axis as the current layout.

Other

A - Go to page (number pad)

L - Open notes overlay for current book

A (notes open) - Edit note via on-screen keyboard

B - Exit notes overlay/exit reader

Plus - Toggle help overlay

Screenshots

WookReaderSwitch-01.png WookReaderSwitch-02.png WookReaderSwitch-03.png WookReaderSwitch-04.png

Changelog

v0.7.0 — Add touch control!

  • Page swipes: Added swipe gestures for both vertical and horizontal modes (touchscreen and buttons). Customizable in the settings outside a book.
  • Recent folder: Added a "Recent" folder that appears on startup and displays the last 4 opened files.
  • Fixed bugs

v0.6.9 — Return of the rotation

  • Accidentally the notes inside comics replaced the rotation. Sorry! Fixed it, now notes are working from button L.

v0.6.8 — Add notes

  • Add notes for comics/books. You can open them in the folder or while reading!

v0.6.7 — Add comics support!

  • Added comics support
  • Fixed bugs

Credits

  • moronigranja — expanded file format support
  • NX-Shell Team — original application code base
  • Papirus Icon Theme — folder/file icon design inspiration

External links

Retrieved from "https://www.gamebrew.org/index.php?title=WookReader_Switch&oldid=205259"

Advertising: