NickelDissolve v0.7

Fixed

• Page turns now animate in Dark Mode. In Dark Mode the reader draws each page turn with a different, darker waveform, which the mod didn't recognise as a reading turn, so a dark-mode turn fell back to a plain refresh with no sweep. Those turns now animate the same as in day mode. On colour (Kaleido) devices the bands use the matching dark waveform so they stay sharp and don't ghost; on black-and-white devices they reuse the turn's own dark waveform. Confirmed on the Clara BW and Clara Colour.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.6

The same animation, now tuned to each device out of the box.

Improved

• The animation is tuned per device. The number of bands follows the panel size, so the 7-inch Libra Colour (and Libra 2) get more bands than the 6-inch Clara devices and the wipe reads at a comparable pace on each. The Libra Colour in particular is noticeably smoother.
• Crisper bands on colour (Kaleido) devices. The Libra Colour and Clara Colour now sweep with a Kaleido B&W-optimised waveform, so the wipe looks sharper and turns a touch faster. Black-and-white devices are unchanged.

Changed

• nds_strips now defaults to a per-device value (12 bands on 7-inch panels, 10 on 6-inch) instead of a fixed 8. Set it in the config to override, exactly as before.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.5

Fixed

• Tap page turns now sweep the correct way, whatever your tap-zone layout. The sweep direction comes from the actual page turn instead of the side of the screen you tapped, so one-handed or remapped tap zones (say, a big left zone set to go forward) no longer wipe backward.
• The first page turn after waking the device no longer stutters. That turn (and the first turn after opening a book or jumping to a chapter) now does Kobo's normal full refresh, the same as it always did elsewhere, instead of a mistimed sweep that could visibly stall on a just-woken screen.

Removed

• The nds_animate_first_turn setting. The "animate the first turn after opening a book" behaviour it added in v0.3 is what stuttered after a wake, so that turn is back to Kobo's flash.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.4

Changed

• Official device support is now the modern Kobo devices only: Clara BW, Clara Colour, and Libra Colour.
• The Libra 2 and Clara 2E can still install and run it best-effort, but they are not officially supported and may not work as well as supported devices.
• Support for the Elipsa and Sage has been removed entirely: the mod now stays inactive on them as the mod did not work reliably.

Added

• The Reading-settings entry now reflects whether your device is supported.
• The startup log now records the device's hardware revision.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.3

Added

• A "Page turn animations:" setting in the Reading settings page, in the Page Appearance
  section alongside the built-in options, so you can turn the animation on or off without editing
  a config file. It is built to match the native rows exactly, takes effect on the next page turn,
  and is remembered across reboots. On any device where the setting cannot be added cleanly it is
  simply left out, and the config file still works as before.

Fixed

• The first-page-turn animation can no longer fire outside a book. The special handling that
  turns the forced full refresh on a book's first page turn into a smooth animation was only
  guarded by the page-turn buttons, so in rare cases the home screen or a menu could be animated
  by mistake. The mod now tracks whether the reader is actually on screen and only applies that
  first-turn handling when a book is genuinely open.

Improved

• Smoother page-turn animation on i.MX devices such as the Kobo Libra 2. These panels pace the
  wipe with a fixed delay between bands instead of the hardware timing the newer panels use, and
  the default delay is now a little longer so each band settles cleanly before the next. This
  removes the slight steppiness on those devices. Tuned and confirmed on the Kobo Libra 2, which is
  now hardware-verified.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.2

Reliability and polish for the page-turn animation, confirmed on the Kobo Clara BW and Kobo
Libra Colour.

Fixed

• Tap page turns now animate. Taps were misclassified as swipes because the gesture filter
  read widget-local touch coordinates; it now uses screen coordinates, so a tap is recognised as
  a tap and its turn animates (and sweeps toward the side you tapped).

Changed

• Opening a book is now a clean full refresh, and the first page turn animates. Kobo forces
  a full flash on the first turn after opening; the mod now renders that turn as a normal
  animated sweep instead. Set nds_animate_first_turn:0 to keep Kobo's flash on the first turn.
• The render that immediately follows a book open or chapter jump is no longer mistaken for a
  page turn, so opening a book no longer briefly animates its first page.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.

NickelDissolve v0.1

A Kindle-style directional page-turn animation for Kobo: the new page sweeps in as a band-wipe
across the screen instead of a single flat refresh. It works entirely through the e-ink screen's
public update interface, with no driver patching.

Added

• Page-turn animation for every way of turning a page: swipes, taps, and the physical
  page-turn buttons. Backward turns sweep the other way, and a tap sweeps toward the side you
  tapped.
• Per-gesture control (nds_animate_on_swipe, nds_animate_on_tap, nds_animate_on_button)
  and tuning options for the number of bands (nds_strips), speed (nds_delay_us), and
  direction (nds_direction), with sensible defaults tuned per device. nds_mode chooses
  sweep (default), observe, or off.
• Automatic colour-page handling on Kaleido colour panels: pages with colour content refresh
  normally instead of animating, so colours are never distorted.

Device support

• Verified on hardware: Kobo Libra Colour (including colour-page handling) and Kobo Clara BW.
• Expected to work (not yet hardware-verified): Kobo Clara Colour, Libra 2, Clara 2E,
  Elipsa 2E.
• Works but off by default (the wipe is slow on the large panels): Kobo Elipsa and Sage.
  Opt in with nds_mode:sweep.
• Any other device: the mod stays inactive, with no animation and no risk.

Safety

• Only a black-and-white reading page-turn is ever animated; menus, the home screen, and colour
  content pass through untouched.
• If a sweep ever fails, the normal page refresh is shown instead. A bad frame is fixed by the
  next refresh, never a brick. On an unrecognised device or firmware the mod simply stays
  inactive.
• Reversible: delete the uninstall file and reboot to remove it cleanly.

---

Install: copy KoboRoot.tgz to the Kobo's hidden .kobo folder, eject, and reboot. Settings are in KOBOeReader/.adds/nickel-dissolve/config; see the README.

Uninstall: delete KOBOeReader/.adds/nickel-dissolve/uninstall and reboot.