Settings

Covers system settings (home screen), the EPUB reader OK menu, and the TXT reader OK menu separately.

3.5 System Settings (Home Screen)

These are the device-wide settings opened from Settings on the home screen.

Configure how the device behaves. Settings are split into four categories:

Starting with v1.2.0, the settings screen is reorganized into four tabs: Display / Reader / Controls / System. Use Left/Right buttons to switch tabs and Up/Down to pick items. (Original categories: Display / Reader / Controls / System)

3.5.1 Display

  • Sleep screen: Dark (default), Light, Custom, Cover, Cover + Custom, None, or Quick Resume. Cover + Custom uses the cover only while a book is open and the custom image otherwise.
  • Quick Resume sleep screen: Keeps the current page on screen while asleep and shows only a moon icon, so waking is instant. (v1.5.0)
  • Sleep screen cover mode: Fit / Crop
  • Sleep screen cover filter: None (grayscale) / Contrast (B&W) / Inverted
  • Hide battery %: Never (default), In reader, Always. The battery icon is always shown.
  • Refresh rate: Full-refresh interval to reduce ghosting (1, 5, 10, 15, 30 pages)
  • UI theme: Classic, Lyra, Lyra Extended, or RoundedRaff. Lyra Extended shows up to 3 books on the home screen. (RoundedRaff v1.5.0)
  • Sunlight bleed correction: Software fix for direct-sunlight bleed on white X4 units. Hidden on touch devices.
  • Sleep Screen Selector: Preview the BMP images in the SD card's .sleep/sleep folder and tick the ones to use. With none ticked the whole folder is used.
  • System font (UI): Pick an SD-card .epdfont for the whole UI. Han/Kana come from that font and everything else falls back to Pretendard.

3.5.2 Reader

Firmware UI labels: “Reader line spacing”, “Reader screen margin”, “Reader paragraph alignment”, “Extra paragraph spacing”, “Paragraph indent”, “Character-level word wrap”, “Text antialiasing”, etc.

  • Font setting: Choose the custom font for the EPUB/TXT reader (see the Custom Fonts section for details)
  • Reader line spacing: Tight, Normal, Wide (1.00 / 1.20 / 1.40x in the Korean build)
  • Reader screen margin: 5–40 pixels in 5-pixel steps
  • Reader paragraph alignment: Justify (default), Left, Center, Right, or Book style
  • Embedded styles: Apply the EPUB's embedded CSS ON/OFF
  • Hyphenation: Word hyphenation for English etc. ON/OFF. Has no effect while character-level wrap is on — a line can already break at any character, so no hyphen is needed.
  • Reading direction: Portrait (default), Landscape clockwise, Portrait 180°, Landscape counter-clockwise
  • Extra paragraph spacing: When on, adds blank space between paragraphs
  • Paragraph indent: Indent the first line of each paragraph ON/OFF (independent of extra spacing)
  • Character-level word wrap: Break by character instead of by word. On by default in the Korean build; justified lines keep word gaps at 1.0–1.5x a normal space.
  • Text antialiasing: Soft gray edges on text. Page turns may slow down slightly.
  • Images: EPUB body image rendering — Show (default) / Placeholder / Strip. The latter two speed up page turns.
  • Dictionary: Select a dictionary folder under /dictionaries on the SD card. The entry is hidden when no dictionary is installed. (v1.5.0)
  • Customise status bar: Configure chapter page count, book progress, progress bar (book/chapter/hidden) and its thickness, title (book/chapter/hidden), battery, XTC status bar, and the clock with its UTC offset and 12/24-hour format. The clock only appears on X3, which has a DS3231 RTC.

3.5.3 Controls

  • Front button remap: Remap the four front buttons (Back, OK, Left, Right). Hidden on touch devices.
  • Side button order (reader): Prev/Next (default), Next/Prev, or disabled.
  • Front buttons follow orientation: Rotates the front buttons' left/right along with the screen. Hidden on touch devices.
  • Touch reader controls: Enables the reader's touch zones and gestures on devices with a touch controller. Hidden on button-only devices. (v1.5.0)
  • Long press for chapter skip: Skip chapter (default) or page scroll
  • Long-press menu: What holding OK in the reader does — KOSync, Disabled (default), Bookmark, or Dictionary. (v1.5.0)
  • Power button short press: Ignore (default), Sleep, Page turn, Manual Refresh, or Footnotes. Manual Refresh clears ghosting with a single short click.
  • Power button returns from footnote: Appears only when the power button short press is set to Footnotes; the power button then returns from a footnote to your place.
  • Short Back to file browser: When on, short Back goes to the file browser and long Back goes home; when off it is the other way round. While a footnote is open, short Back always returns from the footnote first. (v1.5.0)
  • Tilt to flip page (X3 only): Tilt the device left/right using the built-in IMU (QMI8658). Normal/Inverted flips the direction. Hidden on X4, which has no QMI8658.

3.5.4 System

  • Sleep timeout: Time before automatic sleep, adjustable from 1 to 30 minutes in 1-minute steps, with the 31-minute position meaning Never. Default 10 minutes.
  • Show Hidden Files: Show files/folders starting with . in the file browser (v1.2.0)
  • Remove read books from Recents: Drops a book from the Recent Books list once its End of Book screen is reached. (v1.5.0)
  • Move finished books: Moves a book to the SD card's /Read/ folder once you finish it. (v1.5.0)
  • Wi-Fi Networks: Pick and manage Wi-Fi network connections
  • KOReader sync: Syncs reading position with a KOReader server. Since v1.5.0 you can register an account from the device and choose the document matching method, whether document metadata is sent, and the sync behaviour (ask every time / smart sync). Quick setup guide
  • OPDS servers: Download ebooks from OPDS catalogues. Since v1.5.0 several servers can be registered and managed as a list, and you can set the download folder and filename format (Author-Title / Title-Author / Title).
  • Clear Reading Cache: Remove rendering caches and temporary files (settings and reading positions are preserved)
  • Check for updates: Checks for firmware updates over Wi-Fi. The Korean firmware queries the crosspoint-reader-ko releases. Hidden on touch devices.
  • SD Card Firmware Update: Pick a firmware file (.bin) from the SD card to flash offline. Useful for Korean/CrossPoint firmware updates as well as rolling back to OEM X3/X4 store firmware. See the install guide — method 2. (v1.2.0-ko.15)
  • Language: Pick the UI language. The Korean firmware includes Korean and English only (flash budget); the upstream firmware offers around 20.
Note — settings file format: Since v1.2.0 settings are stored as .json instead of the old binary file, making backup/restore easy. Korean-specific values like customFontPath, characterWrap, and paragraphIndent are also stored in the JSON. (v1.1.1-ko.1+)
3.6 EPUB Reader Menu (OK button)

Pressing the OK button while reading an EPUB opens a reader-specific menu. It focuses on book-related actions, and includes values managed separately from system settings such as progress, orientation, and auto-turn.

  • Chapter Selection: Jump directly to a chapter from the table of contents
  • Footnotes: Visible only when the current book contains footnotes; lets you browse all footnotes at once (v1.2.0)
  • Reader Options: A sub-screen of the reader menu that lets you change the most-used reading settings in one place: font (current font name shown), Reader category (line spacing, screen margin, paragraph alignment, extra paragraph spacing, paragraph indent, character-level word wrap, antialiasing), EPUB-only toggles (embedded styles, image display — hidden in TXT), the Controls category (side button order, long-press chapter, power-button short press), and sunlight-bleed correction. Going back from Options returns to the menu, and leaving the menu commits all changed values at once (no flash if nothing changed). The home-screen settings and Reader Options share the same definitions, so changes are mirrored both ways. Reading direction stays as the menu's inline cycle and is excluded from Options. (new)
  • Reading direction: Portrait (default) / Landscape clockwise / Inverted / Landscape counter-clockwise — previewed instantly on selection and applied when leaving the menu.
  • Auto Page Turn (pages/min): Pages-per-minute speed (Off / 1 / 3 / 6 / 12) (v1.2.0)
  • Jump to %: Type the percentage of the whole book to jump to that position
  • Take Screenshot: Save the current page as BMP into the SD card's /screenshots folder (see the screenshot guide)
  • Show page as QR: Display the current web server / hotspot address as a QR so you can connect from your phone
  • Go Home: Save the current reading position and return to the home screen
  • Sync Progress: Upload the current reading position to the KOReader Sync server (see the KOReader Sync guide)
  • Clear Book Cache: Delete only the rendering cache (inside .crosspoint) for the current book; settings and reading position are preserved
  • Reset Reading Timer: Reset the accumulated reading time of the current book to 0 (two-step confirmation, v1.2.0-ko.14). See the Reading Timer section for details
Note: Reading direction and auto-turn values changed in the reader OK menu are stored per book and reflected in the JSON settings. The right side of the menu's progress line shows an accumulated reading-time chip (e.g. Reading Time: 1h 23m).
3.7 TXT Reader Menu (OK button)

TXT files have a flat structure with no chapters, so the menu is simpler than EPUB. Navigation is byte-offset based.

  • Reader Options: Change font, the Reader category (line spacing, screen margin, paragraph alignment, extra paragraph spacing, paragraph indent, character-level word wrap, antialiasing), the Controls category (side button order, long-press chapter, power-button short press), and sunlight-bleed correction in one screen. EPUB-only toggles (embedded styles, image display) are hidden in TXT. Leaving the menu after Options commits all changes at once; if nothing changed, you return to the page without a flash. (new)
  • Reading direction: Portrait / Landscape clockwise / Inverted / Landscape counter-clockwise
  • Auto Page Turn (pages/min): Pages-per-minute speed (Off / 1 / 3 / 6 / 12) — same options as EPUB
  • Long-press page jump: Off / 10 / 20 / 50 / 100 — long-pressing the page button for over a second skips this many pages. When Off, long-press still only flips one page (v1.2.0-ko)
  • Jump to %: Jump by percentage of the whole file
  • Take Screenshot: Save the current page as BMP
  • Go Home: Save the current position and return to the home screen
  • Reset Reading Timer: Reset the accumulated reading time of the current TXT file to 0 (v1.2.0-ko.14). Like EPUB, an accumulated time chip appears on the right of the menu's progress line. See the Reading Timer section for details

The TXT reader menu has no Chapter Selection / Footnotes / Show page as QR / Sync Progress / Clear Book Cache — those features only make sense for EPUB and are hidden for TXT. Recent fix: when extra paragraph spacing was on and a paragraph crossed a page boundary, some lines from the previous page would re-appear at the top of the next page. That paragraph-duplication bug is fixed. Known remaining edge case — going backward immediately after a % jump can briefly duplicate one wrapped line; flipping forward once auto-corrects it. Also, the bottom hint on settings / Reader Options screens has been changed from "Toggle" to "Select" for clearer wording.