# Folio Nooir v1.5.8

Folio Nooir v1.5.8

Stable Pages

• Added optional Stable Pages mode for EPUB reading.
• Imports CrossInk META-INF/x-locations.json when available.
• Stores reusable per-book stable_pages.bin data.
• Added progress feedback, cancellation, reuse of valid maps, and memory cleanup.
• Falls back safely to Current Pages when no compatible map exists.
• Added Stable Pages to Settings Profiles.

Shelf Performance

• Recent and Finished now use lightweight metadata checks.
• Missing thumbnails no longer trigger automatic decoding during navigation.
• Improved Refresh Book Cache with bounded processing and safe placeholders.
• Reader exit now shows saving feedback and avoids unnecessary state-file writes.
• reduced redundant shelf redraws and reader-exit prewarming.

EPUB and Image Safety

• Improved handling of invalid dimensions, oversized images, and unsafe geometry.
• Added safer PNG and framebuffer cache writes.
• Added fail-soft image placeholders while preserving the fast path for valid images.

Clippings and Highlights

• Improved highlight restoration after font, CSS, and line-spacing changes.
• Added punctuation and whitespace normalization for matching.
• Improved resolver-cache invalidation after clipping edits.

KOReader Sync

• Improved portable position mapping with CrossPoint fallback data.
• Added editable sync device name support.

# Folio Nooir v1.5.7

Folio Nooir v1.5.7

Changes since the v1.5.7 development baseline:

• Added Clock & Weather location selection using city names, with automatic coordinates and IANA timezone resolution.
• Fixed local clock, date, weather-sync time, and clock-sync time handling after location changes.
• Improved EPUB image stability with lower-memory streaming JPEG decoding and safer image-cache handling.
• Fixed large EPUB images covering the reader footer and status bar.
• Added safer first-install Recent cache detection using lightweight metadata/book cache files.
• Improved OPDS loading feedback, cancellation, and safer temporary-file downloads.
• Enhanced EPUB formatting: paragraph indents, lists, tables, <hr> separators, strikethrough/redaction, and Reader Guide Dots.
• Added Settings Profiles for saving and restoring device settings.
• Hardened settings persistence and recovery to reduce resets and default-setting loss.
• Added favorite sleep-image selection, random-image fallback, recent-image history, and improved overlay handling.
• Optimized Web Transfer to reduce unnecessary EPUB parsing and cover decoding.
• Added Web Transfer metadata editing for EPUB, XTC, TXT, and Markdown books.

# Folio Nooir v1.5.6

Folio Nooir v1.5.6

This release focuses on faster bookshelf navigation, large-library handling, sleep/wake behavior, and X3/X4 compatibility.

Highlights

• Faster Library, Recent, and Finished navigation with cache-first metadata handling.
• Improved filename search and recursive Search All Folders.
• Two-stage Retrieve All Book Details with progress feedback, cache skipping, thumbnail recovery, and Stop for now support.
• Retrieval refreshes only the affected book instead of rebuilding the entire shelf.
• Added Clock & Weather sync with cached results and Web UI support.
• Added persistent To-Do List with on-device, Web UI, and sleep-screen modes.
• Added independent Quick Resume and Resume Reader on Wake settings.
• Added battery percentage to bookshelf headers.
• Added lightweight reading pages, pace, streak, and calendar statistics.
• Improved Web Transfer responsiveness and on-demand metadata editing.
• Improved newer X3 display detection with UC8279d/UC8253 fallback handling.
• Default build remains non-BLE; Bluetooth/page-turner support is still experimental.

Hardware warning

Folio Nooir has been physically tested on an older Xteink X4 revision. Newer X3 panels are supported through conservative controller detection, but every hardware revision has not been individually tested. Keep a known-good recovery firmware before flashing. X4 Pro/S3 hardware is not supported.

Folio Nooir is a personal bookshelf-focused fork of CrossPoint Reader, with selected ideas adapted from CrossInk.

# Folio Nooir v1.5.5

Folio Nooir v1.5.5

for newer display x3.wait for 1.5.6. am gonna update code and double check it first!

• Added page-turn statistics for EPUB, XTC/XTCH, and TXT.
• Added per-book and daily page counts, reading pace, and current/best streaks.
• Expanded on-device and web reading statistics, calendar data, and JSON export.
• Improved Recent, Finished, and Library responsiveness by avoiding unnecessary full-shelf redraws.
• Retrieve All Book Details now uses a streaming queue with lower memory usage.
• Valid cover and metadata caches are skipped automatically.
• Added visible retrieval progress with the current book name.
• Added Stop for now for large-library retrieval.
• Per-book retrieval refreshes only the affected shelf entry.
• Retrieval dialogs now use a light-gray background with black text to reduce ghosting.
• Page-turn statistics are saved only when leaving a book, so they do not slow reading or add SD-card writes.
• Default build remains non-BLE; Bluetooth is still experimental.

# Folio Nooir v1.5.4

v1.5.4 changes

• EPUB image rendering now warms missing image caches before font prewarming, reducing failures caused by fragmented heap memory.
• Added a bounded TJpgDec fallback for valid baseline JPEGs that JPEGDEC cannot decode because of long AC Huffman tables. Normal JPEGs remain on the faster JPEGDEC path.
• Added safer lazy image extraction, invalid-cache cleanup, one-time source refresh, and failure memoization so a broken image cannot repeatedly stall page rendering.
• Problematic EPUB images are cached in the compact pixel-cache format after successful decoding, making later visits fast and avoiding repeated SD/decoder work.
• Improved XTC/XTCH streaming by retaining the rendered black-and-white plane in small framebuffer chunks, reducing full-page rereads while keeping low-memory fallback behavior.
• Reduced redundant Recent-book SD writes and corrected featured-cover invalidation when the selected book changes, improving home-screen responsiveness.
• Updated the firmware version to 1.5.4. These changes use the shared X3/X4 code path; real-device validation remains recommended on every hardware revision.

# Folio Nooir v1.5.3

v1.5.3 changes

• Refresh Book Cache now rereads the book cover, title, author, and synopsis used by the featured-book panel.
• Refreshing metadata preserves reading progress, status, bookmarks, and clippings; an intentionally removed synopsis can also be cleared.
• Metadata refresh uses the lightweight metadata-only path, processes one book at a time, and skips unnecessary writes to keep Recent and Library responsive.
• Manual refresh always rereads metadata even when an older thumbnail is still present, then regenerates the cover when needed.
• The refresh path uses the shared X3/X4 code path and adds no X4-only behavior; X3 remains supported pending additional hardware testing.
• Multi-dictionary lookup now shows the source dictionary, supports switching/history and searching all prepared dictionaries, and avoids blocking on unprepared alternate dictionaries.
• Dictionary indexes can be prepared one at a time with percentage progress, Back-to-cancel, and resumable checkpoints; stale or replaced dictionary sidecars are detected and rebuilt.
• Dictionary font and dictionary font-size settings remain independent from reading typography.
• Full synopsis now decodes HTML entities and preserves paragraph, heading, list, and line-break structure while paging.
• Long-press book actions can be opened repeatedly after returning from an action; menu transitions now close the popup before opening Settings or another activity.
• Clipping + Cover sleep cards now show only the saved clipping text and a compact - Book title, page N attribution.
• Reader control parity: front and side long-press actions both support OFF, chapter skip, font-size cycling, and orientation change; Menu and Power long-press pickers expose the shared reader actions (Reader Options, statistics, screenshot, sleep, bookmark, dictionary, dark mode, and KOReader Sync where supported).
• A new Controls tab in Reader Options lets these front, side, Menu, and Power actions be changed without leaving the book; Menu sleep uses the normal sleep-screen/deep-sleep path.
• UI Scale now applies to Library text, tabs, menus, book actions, synopsis, book/reading statistics, calendar, clipping/bookmark lists, and Reader Options while leaving reading-page typography, bookshelf cover geometry, and the 4 x 2 grid independent. Recent and Finished remain entirely on the fixed-font shelf path for faster navigation.
• Library search offers an instant current-folder filename filter or an explicit recursive Search All Folders mode. The recursive scan is processed in small batches, never parses EPUBs or retrieves covers, and can be cancelled with Back; the same menu entry clears the search.
• Recent/Finished startup no longer validates every thumbnail or retrieves partial caches in the background. Existing metadata is shown immediately with a title/filename fallback; first-time empty caches use a visible one-book-at-a-time warm-up, and refresh remains manual.

# Folio Nooir v1.5.2

Folio Nooir is a Folio bookshelf-focused firmware fork based on CrossPoint Reader.

Highlights changes for this build

• Improved Folio Nooir bookshelf UI and navigation
• Faster Recent, Finished, and Library interactions
• Lazy book metadata and cover retrieval
• Improved EPUB CSS, tables, images, and memory handling
• Bookmark/clipping access from Reader and bookshelf menus
• New Cover + Overlay sleep mode
• Transparent PNG overlay validation
• Clipping + Cover sleep screen using the clipping’s own book cover
• Improved sleep refresh and ghosting handling

Important hardware warning

This firmware has been physically tested only on an older Xteink X4 revision.

X3 and newer X4 display panels still require real-device validation. Keep a known-good recovery firmware before flashing.

Bluetooth page-turner support remains experimental and hidden.

Release asset:

firmware.bin

#Folio Nooir v1.5.1

Changes from this development stage

New settings

• UI scale control
• Dictionary font selection
• Dictionary font-size control
• Fine line-spacing adjustment
• Power-button short/long actions
• Front-button remapping, including reader-specific mappings
• Side-button layout and long-press actions
• Reader Options shortcuts while reading

Highlights and clipping

• Added EPUB text selection highlighting while clipping
• Added saved clippings with per-book storage
• Added /My Clippings.txt export
• Persistent in-page highlights are not implemented yet

Library menu

• Added Retrieve All Book Details
• Displays: “Retrieve all books details. Please be patient.”
• Retrieves metadata and covers for books on the SD card
• Added retrieval feedback and cache reuse

Library layout and navigation

• Featured book now matches the Recent screen style
• Book synopsis displays up to five lines
• Updated header buttons:

Library

• First: Menu
• Second: existing action
• Third: Recent
• Fourth: Finished

Recent

• First and second: unchanged
• Third: Library
• Fourth: Finished

Finished

• First and second: unchanged
• Third: Library
• Fourth: Recent

Bug fixes

• Removed the unreliable Browse Files option from Folio menu popups
• Prevented Browse Files from opening the wrong folder
• Library navigation now stays in the bookshelf workflow
• Menu popup now closes before opening Settings or other activities
• Added retrieval popup handling for lazy book metadata loading

The retrieval logic is shared across X3/X4 builds, but X3 popup behavior still needs physical-device testing.

# Folio Nooir — Preview Release BETA

Folio Nooir — Preview Release

Folio Nooir introduces a bookshelf-focused reading experience for the Xteink X4.

⚠️ Hardware warning

This build has only been tested on the older Xteink X4 hardware revision. Do not install it on newer X3/X4 display models unless compatibility has been confirmed.

Highlights

• New Folio Nooir bookshelf interface
• Library, Recent and Finished sections
• Cover, title, author, synopsis and progress display
• Persistent Reading, On Hold and Finished states
• Daily reading time and finished-book statistics
• Improved EPUB CSS, tables, images and metadata
• Typography controls displayed in points
• Faster cached bookshelf loading
• Web-based library and file transfer
• Custom BMP and PNG sleep images
• New Folio Nooir boot logo

Book actions

Long-press a book to:

• Mark it as Reading, On Hold or Finished
• Reset its reading progress
• Refresh its metadata and cover cache
• Remove it from Recent/Finished without deleting the ebook

Clear Reading Cache now also clears stale Recent and Finished entries. Your ebook files are not deleted.

Known limitations

• Bluetooth remote support remains experimental and may cause instability.
• Some complex EPUB layouts and CSS may not render exactly like a desktop browser.
• The first cover or metadata extraction may take a moment.
• Only the older Xteink X4 has been physically tested.

Installation

Download the .bin file and select it through the CrossPoint web flasher’s custom-firmware option.

Keep a copy of your previous working firmware before flashing.

Credits

Folio Nooir is a personal fork of CrossPoint Reader. Thanks to all CrossPoint contributors for the reader engine and hardware foundation.

# Folio Nooir 1.5.0

Folio Nooir 1.5.0

A bookshelf-focused firmware fork of CrossPoint Reader for Xteink devices.

Highlights

• Folio Nooir bookshelf interface with Library, Recent, and Finished views
• Featured-book cover, title, author, synopsis, progress, reading time, and sessions
• 4×2 cover grid with progress ribbons
• Persistent reading states: New, Reading, On Hold, and Finished
• Long-press actions for book statistics, cache refresh, progress reset, status changes, and removal from Recent/Finished
• Improved EPUB styling, CSS, tables, images, metadata, and memory handling
• Improved XTC/XTCH rendering
• Point-based font size, margins, and line spacing
• Dark mode
• Multi-dictionary support and dictionary history
• Text clipping
• Reading statistics and reading calendar
• Folio Nooir-styled web interface with file transfer, book editing, covers, statistics, and JSON export
• Custom PNG/BMP sleep images
• Random sleep images
• Transparent page-overlay sleep mode
• Ghosting reduction and cleaner screen refreshes
• Folio Nooir branding and boot logo
• OTA update support through the Folio Nooir GitHub releases

Hardware warning

This firmware has only been physically tested on the older Xteink X4 hardware revision.

The display-driver direction follows the compatible X3/X4 work described by CrossInk v1.5.0-rc-3, which reports fixes for known X3 and X4 display variants and support for the latest X4 battery latch.

X3 compatibility is expected but has not yet been physically tested with Folio Nooir. X4 Pro and S3 models are not supported.

Keep a known-good recovery firmware before flashing. An incompatible display panel or board may require recovery through the SD-card firmware picker.

Installation

1. Download the release asset named exactly firmware.bin.
2. Keep a backup of your current working firmware.
3. Flash using the CrossPoint web flasher or the supported SD-card update method.
4. Reboot the device after flashing.

Known limitations

• Bluetooth page-turner/HID support remains experimental and may be unstable.
• X3 hardware testing is still pending.
• Some books may require a manual cache refresh after first installation.
• EPUB compatibility can vary between books depending on their CSS and embedded images.
• This is an experimental community firmware. Flash at your own risk.

Folio Nooir is built on CrossPoint Reader, with CrossInk used as a reference for compatible Xteink display and reader improvements.