Skip to content

Releases: uxjulia/CrossInk

v1.5.1-rc-4 (X4 Pro Support)

Pre-release

Choose a tag to compare

@uxjulia uxjulia released this 21 Aug 20:51
d90e7f6

Tip

You can flash stable and pre-release builds using Crossink's web companion app, Inky

This release brings compatibility to the X4 Pro.

Changes in RC-4

  • Includes SDK updates to fix the mirrored display issue seen in latest X4 Pro display variants.
  • The lowest brightness setting on the X4 Pro is now 10x dimmer thanks to updates in the FreeInk SDK.
  • You can now customize what pressing the Up + Down buttons together do. If you're on a touchscreen device, this will always open the reader menu when your touchscreen is disabled. Set the shortcut from Settings > Controls > Side Buttons.
  • XTC covers should display correctly in home screens across all themes now (fixes #582)
  • Sleeping via the Quick Actions menu should display the book cover now (fixes #583)
  • Page turns mapped to the home button should work when reading XTC/XTCH files now (fixes #580)
  • Swiping to go to previous chapter should land you at the start of the chapter now (fixes #575)
  • Chapter skips trigger after elapsed time instead of release on long-press of side buttons (fixes #576)
  • Touch devices should see a "Sync" button when doing a Nearby Stats Sync now (fixes #573)
  • TXT font-size gestures and shortcuts work correctly (fixes #577).
  • Chapter skips trigger when the long-press duration threshold is reached, rather than on release (fixes #576).
  • Touch dictionary lookup can switch dictionaries after a miss (fixes #591).
  • Low-memory EPUB layout exits safely instead of aborting/restarting (fixes #597).
  • Button long-press actions no longer interfere with touch page turns (fixes #594).
  • Holding buttons in the saved-clippings list no longer crashes (fixes #593).
  • EPUB table captions no longer crash low-memory indexing (fixes #565).

New

  • Full touch support for Xteink X4 Pro
  • New Quick Actions menu where you can set 5 shortcuts accessible via any of the shortcut buttons. Settings > Controls > Quick Actions
  • The Power + Up button combo can now be assigned to a shortcut. Get to it from Settings > Controls > Power button > Power + Up
  • New Quick Lock shortcut for locking the device without actually putting it to sleep. This disables all buttons (and the touchscreen) and must be unlocked with the same button shortcut.

Changed

  • Fonts now display their installed point sizes next to their name (addresses #491)
  • The boot-up splash screen has been removed. You will now wake directly to your last screen
  • Mark as Finished and Controls have been moved to the third tab (settings gear icon) in the reader menu
  • Wi-Fi passwords are now shown while entering them.

Fixed

  • Flashing when accessing Wi-fi related activities (fixes #495)
  • Landscape dictionary navigation (fixes #493)
  • Enables touch on end-of-book suggestions (#496)
  • Improve loading of custom dictionary font (fixes #501)
  • XTC table of contents getting cut off (fixes #494)
  • Inaccurate clipping/highlights after font/font-size changes (fixes #492)
  • "Change Font" shortcut not working on front buttons (fixes #507)
  • Overlapping pages in XTC (fixes #485)
  • Improved table rendering for large, complicated tables (fixes #506)
  • Some data missing after lightweight network restarts (fixes #512)
  • Battery drain on Seeed Sticky (fixes #516)
  • Empty crash report after flashing due to false watchdog error
  • Custom sleep-image folders load faster and rebuild correctly after file changes.
  • Quick Resume no longer shows a blank page after EPUB next-chapter indexing (fixes #535).
  • Large EPUBs with thousands of chapters should now finish indexing more reliably on X3/X4 without running out of memory.

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.5.1-rc-3 (X4 Pro Support)

Pre-release

Choose a tag to compare

@uxjulia uxjulia released this 18 Aug 01:03
efb7340

Tip

You can flash stable and pre-release builds using Crossink's web companion app, Inky

Warning

If you have a touchscreen and like to disable the touchscreen in the reader, make sure to set a button shortcut to something that will allow you to open the reader menu or toggle the touchscreen or you’ll get stuck. The power button will no longer act as the escape hatch that opens the reader menu in this release. I’ll add a different escape hatch shortcut in the next release.

This release brings compatibility to the X4 Pro.

I'd appreciate help verifying the following:

  • All UI components are touch-friendly on X4 Pro/Sticky devices
  • All Quick Action items launch as expected
  • X3/X4 devices do not display any touch-only related UI elements
  • Power + Up button combo shortcuts work as expected

Changes in RC-3

  • You can now set a schedule for when the X4 Pro's frontlight is enabled when you turn the device on in Settings > Display > Frontlight > Schedule. When this is set to ON, the device will automatically turn on the frontlight when you wake the device if the current time is between your defined Start and End time. Both times need to be set for this to take effect.
  • Added option to Restore Light on Wake in Settings > Display > Frontlight.
  • On touch devices, you can now pinch to resize the font. Pinch out (zoom in) to increase the font size, pinch in (zoom out) to decrease the font size. You can toggle this off if you want in Settings > Controls > Taps & Gestures > Pinch to Resize Font
  • Adds two-finger swipe gesture settings in Settings > Controls > Taps & Gestures > Two-finger Swipe. The allowed shortcut list right now is intentionally limited. I'm open to adding more in the future, but for a first pass I want to limit it to make testing and verification a bit easier.
  • When inside the reader, use two fingers to rotate the screen orientation. Rotate your fingers in the direction you want the screen to rotate. Hint: rotate at least 90° and try to keep one finger stationary. You can also place two fingers on the screen and physically rotate the screen instead.
  • On touch devices: Tap to show/hide the bottom status bar and clock in the reader.
  • New separate setting for top/bottom and left/right margins. Adjustable from 5-150.
  • Power button no longer acts as the escape hatch if you've disabled the touchscreen. The implication is that users are now responsible for designating the appropriate shortcut to exit a disabled touchscreen. The benefit is that you can now use your designated power button shortcut. (fixes #542)
  • Setting options in Quick Action should only require one tap now (fixes #550)
  • File Transfer should no longer crash on X4 Pro (fixes #553)
  • Quick Actions set with the long-press power button shortcut triggers after elapsed duration instead of release now (fixes #552)
  • Certain Quick Action shortcuts should no longer open the reader menu after being triggered (fixes #554)
  • Screen refresh shortcut on X4 does a HALF_REFRESH (single flash) instead of FULL_REFRESH (multiple flashes) again (fixes #557)
  • X4 now gets a HALF_REFRESH(single flash) on wake to help with ghosting (fixes #558)
  • EPUBs with thousands of TOC items should no longer crash (fixes #565)
  • Preview text of clippings should display the entire clipping now (fixes #566)
  • Ellipses highlight properly when clipped (fixes #568)

New

  • Full touch support for Xteink X4 Pro
  • New Quick Actions menu where you can set 5 shortcuts accessible via any of the shortcut buttons. Settings > Controls > Quick Actions
  • The Power + Up button combo can now be assigned to a shortcut. Get to it from Settings > Controls > Power button > Power + Up
  • New Quick Lock shortcut for locking the device without actually putting it to sleep. This disables all buttons (and the touchscreen) and must be unlocked with the same button shortcut.

Changed

  • Fonts now display their installed point sizes next to their name (addresses #491)
  • The boot-up splash screen has been removed. You will now wake directly to your last screen
  • Mark as Finished and Controls have been moved to the third tab (settings gear icon) in the reader menu
  • Wi-Fi passwords are now shown while entering them.

Fixed

  • Flashing when accessing Wi-fi related activities (fixes #495)
  • Landscape dictionary navigation (fixes #493)
  • Enables touch on end-of-book suggestions (#496)
  • Improve loading of custom dictionary font (fixes #501)
  • XTC table of contents getting cut off (fixes #494)
  • Inaccurate clipping/highlights after font/font-size changes (fixes #492)
  • "Change Font" shortcut not working on front buttons (fixes #507)
  • Overlapping pages in XTC (fixes #485)
  • Improved table rendering for large, complicated tables (fixes #506)
  • Some data missing after lightweight network restarts (fixes #512)
  • Battery drain on Seeed Sticky (fixes #516)
  • Empty crash report after flashing due to false watchdog error
  • Custom sleep-image folders load faster and rebuild correctly after file changes.
  • Quick Resume no longer shows a blank page after EPUB next-chapter indexing (fixes #535).
  • Large EPUBs with thousands of chapters should now finish indexing more reliably on X3/X4 without running out of memory.

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.5.1-rc-2 (X4 Pro Support)

Pre-release

Choose a tag to compare

@uxjulia uxjulia released this 14 Aug 22:28
09d0045

Tip

You can flash stable and pre-release builds using Crossink's web companion app, Inky

This release brings compatibility to the X4 Pro. I have plans for features and UI updates, but for now this is a working version for those waiting for Crossink support.

I'd appreciate help verifying the following:

  • All UI components are touch-friendly on X4 Pro/Sticky devices
  • All Quick Action items launch as expected
  • X3/X4 devices do not display any touch-only related UI elements
  • Power + Up button combo shortcuts work as expected

Changes in RC-2

  • Full Xteink X4 Pro USB Drive support. Go to File Transfer > USB Drive while your device is USB-connected and it should pop-up as a drive on your computer. Note: It may take about 30 seconds for it to actually appear.
  • You can now use Inky to send files over USB to your X4 Pro.
  • The Power + Up button combo can now be assigned to a shortcut. Get to it from Settings > Controls > Power button > Power + Up
  • New Page Turn Gesture setting in Settings > Controls with options for: Tap & Swipe (default), Tap Only, Swipe Only, Inverted Tap (for lefties), and Disabled (no page turn gestures but swiping up/down to trigger those actions still work)
  • New "Quick Lock" shortcut for locking the device without actually putting it to sleep. This disables all buttons (and the touchscreen) and must be unlocked with the same button shortcut.
  • Wi-Fi passwords are now shown while entering them.
  • KOReader Sync no longer risks crashing from a render stack overflow (fixes #529).
  • Quick Resume no longer shows a blank page after EPUB next-chapter indexing (fixes #535).
  • TOC footnotes now return to the correct reading position (fixes #537).
  • Reading cache settings now include touch buttons for clearing the cache (fixes #533).
  • Touchscreen disabling now only takes effect when touch input is disabled (fixes #534).
  • Nearby Position Sync startup is more reliable (fixes #531).
  • Touch context menus now show up properly (fixes #532).
  • Quick Actions no longer trigger incorrect actions or leave stale popups behind (fixes #524 and #525).
  • Quick Actions modal closes before going to sleep (fixes #543)
  • Large EPUBs with thousands of chapters can now finish indexing on X3/X4 without running out of memory.
  • Touch releases are now handled correctly in settings and option popups.
  • Custom sleep-image folders load faster and rebuild correctly after file changes.
  • OPDS browsing no longer risks overflowing the Wi-Fi task stack on ESP32-S3 devices.
  • Nearby sync and transfer status messages now wrap correctly instead of overlapping.

New

  • Full touch support for Xteink X4 Pro
  • New Quick Actions menu where you can set 5 shortcuts accessible via any of the shortcut buttons. Settings > Controls > Quick Actions

Changed

  • Fonts now display their installed point sizes next to their name (addresses #491)
  • The boot-up splash screen has been removed. You will now wake directly to your last screen
  • Mark as Finished and Controls have been moved to the third tab (settings gear icon) in the reader menu

Fixed

  • Flashing when accessing Wi-fi related activities (fixes #495)
  • Landscape dictionary navigation (fixes #493)
  • Enables touch on end-of-book suggestions (#496)
  • Improve loading of custom dictionary font (fixes #501)
  • XTC table of contents getting cut off (fixes #494)
  • Inaccurate clipping/highlights after font/font-size changes (fixes #492)
  • "Change Font" shortcut not working on front buttons (fixes #507)
  • Overlapping pages in XTC (fixes #485)
  • Improved table rendering for large, complicated tables (fixes #506)
  • Some data missing after lightweight network restarts (fixes #512)
  • Battery drain on Seeed Sticky (fixes #516)
  • Empty crash report after flashing due to false watchdog error

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.5.0

Choose a tag to compare

@uxjulia uxjulia released this 08 Aug 21:46
0de623e

Note

This release should be SAFE for all known X3 and X4 variants.

Warning

This release is NOT compatible with the X4 Pro, please do not attempt to flash it. I promise an update is coming soon for it!

Xlarge has been removed from this release

See the following discussion for more info. You can download Crossink fonts in all sizes from https://inky.crossink.dev/#downloads. Place them on your SD card inside a .fonts or fonts folder.

Release Notes

This release might be one of the largest ones so far as it brings a LOT of changes. I've also been working on a companion web app for Crossink called Inky. It's got various tools that I thought would be helpful. As someone who doesn't particularly like having to connect via the File Transfer method to send files, I made a standalone EPUB optimizer that can send EPUBs to your device via USB (only possible if you're unlocked, if not you can still download the file to transfer to your SD manually). I also made a dictionary prep tool to speed up dictionary lookups, a downloads page for fonts and pre-prepped dictionaries, and a dedicated Crossink flash tool. I hope you guys find it useful!

🎉 Oh yeah, you can also now easily flash stable and pre-release builds at https://inky.crossink.dev/#flash-tools

New

  • Full touch support for Seeed Sticky (Shoutout to the Seeed team for sending me an early development unit). If you're interested in one, get one through Crosspoint's shop to support development and get a discount while you're at it.
  • Dictionary lookup has been added, including suggestions and lookup history. "Look Up Word" can also be assigned as a short or long-press action. Dictionary lookup works with any compatible StarDict dictionary. Learn more about the dictionary feature here.
    • To get you started with some dictionaries, I've included 4 monolingual English dictionaries already optimized that you can download here: Inky.
    • If your dictionary includes IPA transcriptions, you can also download Crossink fonts that include the IPA glyphs under Dictionary Fonts from the above link.
    • You can set a custom dictionary font/size globally or per book when you have at least one dictionary added. Get to it from Settings > Reader > Font Options or from inside a book with Book Options > Font Options
  • This release re-introduces upstream Crosspoint's incremental indexing, however this time you can choose between Incremental or Full Sectionindexing globally or per book. Incremental indexing prepares a few pages ahead while Full Section indexing (the old default behavior and will remain the default) prepares the entire section/chapter from the beginning.
    • There are pros and cons to each method. Learn more here.
    • Incremental indexing is still considered experimental. Use Full Section indexing if you generally don't have issues with EPUBs rendering.
  • Nearby File Transfer can send EPUB, TXT, XTC, XTCH, PNG, and BMP files directly between two CrossInk devices without a Wi-Fi network. Long-press from the File Browser or Recent Books to see the new option for Send to Nearby Device. On the receiving device, navigate to File Transfer > Receive File
  • Word Spacing setting has been added to Settings > Reader > Font Options > Word Spacing. This allows you to set the spacing between words up to 5 levels.
  • RTC-enabled devices can choose the date format shown in the settings menu and numeric separator in Settings > System > Device.
  • The web EPUB optimizer now splits oversized chapters into more device-friendly sections before sending them to the device. This is on by default. Note: Split sections may cause unexpected paragraph breaks where the optimizer has split the section. This is normal. Split sections will also show a "~" when estimating the chapter pages.
  • Small-caps rendering using a modified capitalized version of the font. This eliminates the need for the font to include small-caps.
  • EPUB rendering will now more aggressively try a silent restart. If that doesn't help then it will try falling back to a lighter rendering mode. Silent restarts allow the reader to reclaim fragmented memory to be able to properly render the book, but you may also sometimes see the screen start to slowly gray, before recovering to its normal state. If a silent restart happens during reading, you'll typically see "Loading", followed by "Indexing". This is all normal and a tradeoff that prevents the device from crashing or showing the "Chapter takes too much memory" error.

Changed

  • The setting for Download Font Size Range now displays the font point-size ranges: 8–12pt, 10–16pt, 14–20pt, and 8–20pt, replacing the old build names it corresponded to.
  • The Download All option has been removed to avoid excessive screen ghosting after very long Wi-Fi usage (downloading all fonts takes a very long time and is not recommended); fonts can still be downloaded individually or updated together.
  • File Transfer, KOReader Sync, OTA updates, and OPDS browsing now start with more memory available for network operations by doing a silent restart and loading only the necessary data before starting the activity.
  • The web file manager can delete non-empty folders and, when hidden files are shown, remove hidden or system-managed SD card items after confirmation.
  • Underlines and strikethroughs now display connected instead of just word by word.
  • Max number of clippings has increased from 64 to 256. The limit exists to bound RAM usage.
  • The full screen refresh during wake and sleep which caused visible flashing has been removed.

Fixed

  • Background silent indexing on the 2nd to last page of a chapter should work again for Full Section indexing (fixes #383)
  • EPUB footnote and cross-reference previews now show the complete note when the link targets the middle of a paragraph. (fixes #406)
  • EPUB clipping now keeps the correct text, font, Bionic Reading layout, and descenders when highlighting/clipping when memory is low (fixes #405 and #385)
  • Reader popups, sleep messages, and KOReader Sync labels now keep the correct orientation. Long menus show a scrollbar. (fixes #409)
  • Manage Fonts is more reliable with large font catalogs and returns to Font Options when leaving without changes. (fixes #401)
  • KOReader Sync, web transfers, and authentication now recover more reliably from fragmented memory, stalled connections, and inactive saved Wi-Fi connections. (fixes #391 and #404)
  • When doing a manual screen refresh, anti-aliasing should be preserved for EPUB and TXT(fixes #398)
  • Split Cyrillic texts should render more reliably now (fixes #400)
  • Estimated time left should display for XTC files now (fixes #399)
  • Web UI should work more reliably when navigating to Settings and Fonts tab (fixes #351)
  • Reading stats button labels now correspond to the user's mapped buttons (fixes #411)
  • Clippings/highlights should preserve the highlighted text better after font changes (fixes #426)
  • Highlighting/clipping in dark mode now shows the proper inverted selection (fixes #431)
  • Table rendering should be more reliable now while reducing the minimum required free memory needed
  • Added support for latest X4 battery latch on newer models (without this patch, newer X4's could seem unresponsive unless connected to USB power)

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.4.0.1

Choose a tag to compare

@uxjulia uxjulia released this 29 Jul 00:37
54ba245

Warning

Note: If you already have Crossink flashed on your device, this message is not for you, and you can safely ignore this update.

THIS PATCH IS NOT 100% GUARANTEED TO WORK. THERE ARE POSSIBLY THREE X3 DISPLAY VARIANTS (the existing one and 2 new ones) AND THIS PATCH ONLY COVERS 2 OF THEM. IF YOU HAVE A NEWER X3 MODEL (DELIVERED AFTER JULY 21ST OR SO) AND DON'T WANT TO RISK IT, STAY ON STOCK UNTIL WE GET MORE INFO FROM XTEINK ABOUT THEIR NEW DISPLAYS**

If you just received a new X3 or X4 model, there is a chance that you have one of the newer display panels that Xteink has switched to. These newer panels do NOT work with Crossink prior to this release. You must download THIS version. If you flash an older version, your display might freeze up or otherwise be unusable when you flash the firmware. Some newer X4 models require a patch so that they function properly when disconnected from USB. That patch is in the v1.5.0 pre-release.

Release Notes

This is purely a patch to make sure people with newer X3 models that use a different display driver don't get their devices soft-bricked.

A new release is coming soon, I promise! I just wanted to get this out before more people start receiving the newer devices.

New

  • Added device detection to determine the correct display driver to use.

v1.4.0

Choose a tag to compare

@uxjulia uxjulia released this 10 Jul 13:40
b7f6708

Warning

Firmware build variants are being simplified and the built-in ChareInk font is being removed

With SD card font downloads working more reliably, CrossInk is starting a phased move toward a single firmware build. no_emoji has already been dropped. The next build being phased out is teensy, therefore this release does not include it. See the following discussion for more info. I've included all built-in fonts (Bitter, ChareInk, Lexand Deca) across all build size variants compiled as .cpfont files for your convenience. Download, unzip, and drop them into your .fonts/fonts folder to get all 8 font sizes (8pt through 20pt) for each font face.

The built-in ChareInk font is being removed from this release to reduce firmware size so that future dictionary support can fit. ChareInk is available to download via Settings > Reader > Font Options > Manage Fonts, or you can download the .zip file included in this release's assets.

Release Notes

New

  • Added a new home and sleep screen theme called "Dashboard" that displays the current book cover alongside reading stats.
  • Added Nearby Position Sync for sending or applying your EPUB reading position between two CrossInk devices. It uses the same file matching method (binary or filename) set in your KOReader sync settings. Get to it from the book's reader menu > Nearby Position Sync.
  • EPUBs optimized via the built-in web uploader will see a new option to display Stable Page Numbers when customizing the in-reader status bar. This works in a similar way to KOReader's Stable Page Numbers by defaulting to 1500 characters per page (roughly 230-300 words per page). You can adjust the number of characters to use in the EPUB optimizer's advanced settings.
  • Added reading stats support for XTC and XTCH files.

Improved

  • OPDS download speeds should be improved (addresses #309)

Fixed

  • Indexing speed should be improved from v1.3.4, which was relying too much on SD card caching which could cause slowdowns on large EPUBs.
  • Auto Turn settings opened from long-press shortcuts now stay open after releasing the shortcut button (fixes #337)
  • Font selection no longer reopens the font preview after choosing a font.
  • EPUB chapters are less likely to open without publisher styling after stale stylesheet data.
  • Chinese and other large SD-card font EPUBs no longer overlap characters after font or line-spacing changes (fixes #321).
  • EPUB clipping selection is more reliable with custom fonts and now follows right-to-left line order for Hebrew and other RTL text (fixes #327).
  • EPUB chapters with many inline anchors or footnote links are less likely to fail with memory errors (fixes #318)
  • Lyra Carousel no longer shows a blank carousel after performing some actions (fixes #317).
  • KOSync failures when too many SD card fonts are installed (fixes #340).
  • Fixed pages/min reading stat getting reset after viewing readings stats from inside the book.
  • Allow clipping/highlighting in footnotes. Note for all clipping activity (but tends to show up more when loading footnotes): If the device does not have enough free RAM to load the SD card font when in clipping/highlight mode, it will fallback to using a built-in font.
  • Lyra Extended covers should render without black bars on the side now (fixes #353).
  • Cancelling font downloads should work more reliably now (fixes #354).
  • Minimal Home no longer swaps to a recent book when returning from Settings when the "Back" button was mapped to the first button (fixes #355).

Notable upstream Crosspoint updates that land in this release:

  • feat: Selection popups #2358
  • feat(reader): End of Book next-book suggestions #2532
  • fix: X4 sleep/boot ghosting #2471 - Note: This causes visible flashing on wake and sleep.

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.3.4

Choose a tag to compare

@uxjulia uxjulia released this 25 Jun 02:02
994fb4b

This release is up to date with the master branch of Crosspoint as of 4:00pm EDT June 24, 2026

Warning

Firmware build variants are being simplified

With SD card font downloads working more reliably, CrossInk is starting a phased move toward a single firmware build. The first step is removing the no_emoji build. See the following discussion for more info.

New

  • EPUB text clipping/highlighting and Kindle-style /My Clippings.txt file. Access it from the in-reader menu. When clippings are present, they will show up alongside bookmarks. Note: My Clippings.txt works just like it does on a Kindle today, which is that it only adds new clippings to the end of the file, it does not delete them. For more info go here.
  • The in-reader menu has been updated to split the growing menu into separate screens for faster navigation.
  • EPUB reader settings can now be saved per book when changed from inside the reader, including font, layout, styling, and reading aids. Global settings in System > Reader still apply to all books automatically until custom settings are applied.
  • For Minimal sleep screen and Reading Stats sleep screen, the default is white text on a black background, but you can now invert their colors by choosing Inverted in the Sleep ScreenColor Filter setting.
  • Added an EPUB Render Mode with options for CrossInk Default, Balanced, and Light. These modes change how much of the book's style CrossInk will attempt to parse and render. Accessible from within a book from Book Options, or by long-pressing the book from the file browser or Recent Books. Read more about it here.
  • Added Portuguese hyphenation support for EPUBs when Hyphenation is enabled (closes #287).

Fixed

  • EPUBs that take too much memory to parse will fallback to either Balanced or Light rendering mode to be able to render the EPUB. If a fallback render mode was used, a pop-up displaying the render mode will display (fixes #278). Note: this does not make EPUB rendering bulletproof. Bionic/guide dots are not turned off through these fallbacks and can still cause issues. The out-of-memory warning now advises to turn those off if they are on.
  • Deleting a large amount of files in web uploader should no longer crash (fixes #269).
  • Long-press Back actions should work more reliably without exiting the window immediately (fixes #267 and #265).
  • Folders with over 200 files should open more reliably without crashing. Note: to improve indexing read/write performance, the file browser will force a 1-line display when it detects over 200 files. A new index will be created at ./crossspoint/fileIndex. The recommendation is still to keep the number of files in each folder under 200 and ideally, closer to 100. (fixes #268)
  • Calibre Wireless transfer status no longer stacks the last received-file message on top of the upload percentage (fixes #282).
  • Font-size changes should now restore closer to your current position (fixes #281).
  • RoundedRaff's battery icon and percent are no longer cut off on certain devices (fixes #263).
  • Progressive JPEG covers should look smoother in generated cover and thumbnail images (fixes #288).
  • Reading Stats and Home should show more consistent book time-left estimates.
  • TXT readers now stay open when pressing page-turn at the end of the file.

Changed

  • The EPUB reader menu now labels per-book reader settings as Book Options and avoids showing duplicate Orientation controls.
  • X3 Tilt Direction labels have been renamed to make the behavior clearer. They now show the full tilt direction: Left-Right, Right-Left, Forward-Back, and Back-Forward. Existing settings are migrated so your current tilt behavior should stay the same after updating (closes #286)
  • Improved loading of large number of footnotes by limiting how many pages are indexed at a time (closes #299)

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way down to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.3.3

Choose a tag to compare

@uxjulia uxjulia released this 13 Jun 20:11

This release is up to date with the master branch of Crosspoint as of 3:55pm EDT June 13, 2026

New

  • You can now add custom shortcuts to Long-press Back Action that applies when within the reader. This would previously open the file browser and remains the default action. Settings > Controls > Front Buttons > Long Press Back Action
  • Additional shortcut options have been added for Calibre Wireless, Join a Network, Create Hotspot, Browse Files, and Footnotes (#222).
  • You can now hide file extensions in the file browser. Settings > System > Files & Cache > Hide File Extension (#248).
  • Minimal theme's 2-line file browser display can now be applied to any theme. Set it from Settings > System > Files & Cache > File Browser Display. Note: If you currently have Minimal theme set, this will default to 2 Lines, otherwise it will default to 1 Line.
  • You can now give your device a name for use during KOReader sync. The device name is also used to identify the device duringNearby Stats Sync (not used in the file creation though). Set it from Settings > System > Device > Device Name.

Fixed

  • Pressing the back button from an option selection no longer takes you back two pages (#250).
  • PNG images in the file browser can properly be previewed now (#251).
  • If your Sleep Screen setting was not set to Cover before opening a book and then you set it to Cover, the Dark sleep screen was being shown instead. This has been fixed now. (#252).
  • Page Overlay PNG images should no longer re-index on every wake and can now use any screen as the background, not just a book's page (#255).
  • Lyra Carousel home icons should now update properly when dynamic icons like OPDS and Bookmarks are added.
  • Improved KOReader sync positions that can land a few pages after chapter start especially in EPUBs with large non-visible style blocks before the actual reading content.
  • RoundedRaff theme: X3's date in Settings no longer overlaps with the battery.
  • A confirmation dialog is now shown when you click on Clear Bookmark List.

Changed

  • The clock display setting label for the X3 has flipped from Show Clock to Hide Clock. Options remain the same and your settings have migrated, i.e. if you had Show Clock= Never, it is now Hide Clock = Always. Now users who don't want to see the clock in the reader can set Hide Clock to In Reader.
  • Clear Reading Cache no longer removes per-book readings stats (global stats were always preserved). To delete individual book stats, you can now navigate to Delete Book's Reading Stats from within the book or from the file browser by long-pressing to bring up the book's context menu. (#253).
  • Crossink now stores settings in its own crossink-settings.json file and will automatically copy over any existing settings.json settings on first creation. What this means: If you flash another firmware and return back to Crossink, your previous Crossink settings will remain the same and no longer get reset to defaults. However, this also means settings you made in Crossink won't follow you to other firmwares unless you rename crossink-settings.json to settings.json. This does not apply to WiFi, OPDS, KOReader, or Recent Books list, which live in their own .json files.

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.3.2

Choose a tag to compare

@uxjulia uxjulia released this 10 Jun 16:45

This release is up to date with the master branch of Crosspoint as of 10:45am EDT June 10, 2026

New

  • Font sizes now use their defined pt size as the name instead of friendly names. This allows custom SD card fonts to be listed more intuitively when mixed with built-in font sizes.
  • Added Dark Reader Mode for EPUB and TXT reading. Settings > Reader > Dark Mode. This can also be added as a new short/long-press shortcut.
  • CrossInk's reading stats now take advantage of X3's real-time clock module! Note: the additional reading stats are intentionally minimal. If you want gamification and full-on heat maps, there are other firmwares out there that do that already and much better than I could (check out vCodex).
    • For X3 devices only, richer reading stats including:
      • Reading streaks
      • Time-of-day and day-of-week charts
      • Editable start/finish dates per book
      • A new "Minimal Stats" sleep screen. (It's just the minimal sleep screen with 2 additional stats: your reading streak and your time-of-day "reader type"). Set it from Settings > Display > Sleep Screen > Minimal Stats
      • Be sure to do a one-time date sync to take full advantage (see next bullet point).
  • X3 only: Added a date display in settings and reading stats. Get it to show up by doing a one-time sync: Settings > System > Device > Sync Date/Time
  • Added backups for all-time reading stats, including manual backup and automatic daily backups (automatic backups for X3 only because it uses the current date). Backups are saved to /.crossink-stats-backup outside of the /.crosspoint folder. Get to it from Settings > System > Reading Stats > All-time Stats
  • Added a new Idle Time Threshold setting (default is 5 minutes). If this value is exceeded on a page, reading time will be ignored (not added to your reading session stat) and the reading pace will not be used to calculate time left in book/chapter. Set it from Settings > System > Reading Stats > Idle Time Threshold
  • Added ability to reset your all-time reading stats. Settings > System > Reading Stats > All-time Stats > Reset All-time Stats
  • Added a File Browser long-press action for choosing a custom sleep-image folder. Crossink will then use that folder to cycle through sleep images instead of the usual /.sleep or /sleep folder.

Fixed

  • Fixed older EPUB bookmarks so they show up again, including books moved into /Read.
  • Fixed KOReader Sync chapter-start drift and made sync errors more specific.
  • Improved Sync Date/Time workflow so it can automatically try saved WiFi networks instead of stopping with a “connect first” message.
  • Improved low-memory reliability around Home, Lyra Carousel, and EPUB rendering.
  • Fixed Vietnamese settings labels showing replacement diamonds.
  • Improved SD-card font download reliability
  • Fixed inverted reader menu side-button navigation.
  • Made the X3 UTC offset picker clearer.

Changed

  • Display, Reader, and Controls settings now open options as a list instead of cycling through options one at a time.
  • Chapter/book time-left estimates have been improved
  • Various UI updates to web uploader UI

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder

v1.3.1

Choose a tag to compare

@uxjulia uxjulia released this 29 May 03:22

This release is up to date with the master branch of Crosspoint as of 10:45pm EDT May 28, 2026

New

  • Font line spacing is now adjustable from 70% - 200%. 70% = very tight, 200% = very wide. (#185). Note that this sets line spacing globally for all fonts so you may still need to tweak it per font, but should improve the experience with SD card fonts that have wildly different native line spacing settings. Get to it from Settings > Reader > Font Options > Line Spacing
  • Settings has been cleaned up to collapse the growing number of settings into submenus. You might hate it, you might love it. It's a lot less overwhelming now though.
  • Added ability to sync CrossInk's all-time reading stats between two devices. File Transfer > Nearby Stats Sync. You only need to click "Sync" on one device to start the syncing process. And you can sync as many devices as you want (two at a time). Read more about it in the docs.
  • Reading Stats now shows separate totals for the current device and all synced devices (if present).
  • Auto Page Turn Interval now remembers the last selected interval per book (#171).
  • Optional EPUB time-left display for chapter or book, based on each book’s saved reading pace. Turn it on in Settings > Reader > Customize Status Bar > Time Left.
  • X3's Tilt Page Turn feature now has a separate direction setting, including left-right and a new forward-back option. This allows a shortcut set for this feature to remember your preferred direction.
  • OPDS servers can choose downloaded filename order: Author - Title or Title - Author to match their sync server (#182). Do this from Settings > System > OPDS Servers > [Your OPDS Server] > Filename
  • Added a new side button layout option to make both reader side buttons turn to the next page. Handy on the X3 if you swap hands a lot (#205). Set it from Settings > Controls > Side Buttons > Layout > Next/Next
  • Added option to display publisher page numbers KOReader style when the EPUB includes them. Enable in Settings > Reader > Publisher Page Numbers.
  • Added a new setting for X3: Settings > Display > Show Clock. Options are Always | Never | In Reader. This setting controls whether the X3's clock is displayed at the top center. Also applies to inside the reader.

Fixed

  • Lyra Carousel loading/indexing/sleep popups render in the right place again.(#186)
  • EPUB first-open and cache rebuild behavior is more reliable, especially when CSS rebuilds fail or memory runs low (#198).
  • EPUBs using SD-card fonts can fall back to the built-in font for chapters that cannot safely lay out with the selected SD font.

Changed

  • The X3 reader clock moved from the bottom status bar to a centered top status bar. I prefer it this way, please don't ask for an option to have it in the bottom status bar. There's way too much going on down there as it is.
  • Reader startup now shows a loading popup (this indicates loading of fonts, CSS, etc.) immediately after opening a book and before indexing/cache work begins. This prevents the device looking like it froze while it was actually loading.
  • Moved X3 clock settings (format, UTC offset, etc.) to Settings > System > Device.

Tip

If you experience any problems, please clear your caches before opening an issue. Start with the least invasive and work your way to the most invasive if problems persist after each step.

  1. Delete book cache (In-reader menu > Delete book cache)
  2. From your SD card: Delete the individual .crosspoint/epub_<hash> folder for the book giving you issues
  3. Delete all reading cache (Settings > System > Files & Cache > Clear Reading Cache)
  4. From your SD card: Delete ALL .crosspoint/epub_<hash> folders and recent.json and state.json
  5. Back up your global_stats.bin and then delete the entire .crosspoint/ folder