From 76396cbf7f9d38fbe5dcf7ff7fc56f60f09b79c9 Mon Sep 17 00:00:00 2001 From: Nico Verbruggen Date: Sun, 22 Mar 2026 19:06:34 +0100 Subject: [PATCH] Updated footer --- web/build.mjs | 6 +-- web/eslint.config.mjs | 1 + web/src/index.html | 75 ++++++++++++++--------------------- web/src/js/nickelmenu-flow.js | 6 +++ 4 files changed, 40 insertions(+), 48 deletions(-) diff --git a/web/build.mjs b/web/build.mjs index dccc884..c6f177d 100644 --- a/web/build.mjs +++ b/web/build.mjs @@ -135,10 +135,10 @@ async function build() { ); // Inject version string and link - html = html.replace('', `${versionStr}`); + html = html.replace('', `Version ${versionStr}`); html = html.replace( - 'href="https://github.com/nicoverbruggen/kobopatch-webui"', - `href="${versionLink}"` + 'id="commit-link" class="site-footer-link" href="https://github.com/nicoverbruggen/kobopatch-webui"', + `id="commit-link" class="site-footer-link" href="${versionLink}"` ); writeFileSync(join(distDir, 'index.html'), html); diff --git a/web/eslint.config.mjs b/web/eslint.config.mjs index ca771e1..86676a1 100644 --- a/web/eslint.config.mjs +++ b/web/eslint.config.mjs @@ -22,6 +22,7 @@ export default [ Worker: 'readonly', requestAnimationFrame: 'readonly', location: 'readonly', + navigator: 'readonly', // JSZip loaded via script tag JSZip: 'readonly', }, diff --git a/web/src/index.html b/web/src/index.html index 2373587..48f99b4 100644 --- a/web/src/index.html +++ b/web/src/index.html @@ -352,6 +352,10 @@  ·  + Feedback +  ·  + GitHub +  · 

@@ -371,56 +375,35 @@

KoboPatch Web UI is a fully client-side web application for customising - Kobo e-readers. Nothing is uploaded to a server — everything runs in your browser. + Kobo e-readers. The actual patching and archive creation (or transfer to your device) runs in your browser.

NickelMenu

-

- NickelMenu adds custom menu items - and tweaks to your Kobo. This tool can install NickelMenu along with an optional curated - configuration (custom menus, fonts, screensavers) or remove it. NickelMenu works with - most Kobo devices and includes a failsafe that automatically uninstalls itself if - something goes wrong. -

+

NickelMenu is a custom menu that hooks into the existing operating system to add extra features.

+ -

Custom patches

-
    -
  1. Device selection — On Chromium-based browsers (Chrome, Edge), the app can - auto-detect your Kobo via the File System Access API when connected over USB. - On other browsers, you manually select your model and software version.
    2. -
  2. Patch configuration — You choose which - kobopatch patches - to enable or disable. Patches in the same group are mutually exclusive. - The patches themselves are community-contributed via the - MobileRead forums.
    3. -
  3. Build — The correct software update is downloaded directly from Kobo's servers - (ereaderfiles.kobo.com). The patcher, compiled from Go to WebAssembly, runs - inside a Web Worker so the UI stays responsive. It extracts - KoboRoot.tgz, applies your selected patches as in-place byte replacements - to the ELF binaries, validates the results (ELF headers, file sizes, archive consistency), - and produces a new KoboRoot.tgz.
    4. -
  4. Install — On Chromium, the patched file is written directly to the - .kobo folder on the device. On other browsers, you download the file - and copy it manually. After safely ejecting, the Kobo reboots and applies the update.
    5. -
- -

Restoring original software

-

- You can also use this tool to restore the original unpatched software. In that case, - no patches are applied — the original KoboRoot.tgz is extracted - from the software update as-is. -

+

Custom Patches

+

The practice of taking the operating system and applying specific known modifications to the prebuilt binaries.

+

Safety

-

- NickelMenu includes a built-in failsafe mechanism. For custom patches, each patched binary - is validated before being included in the output: ELF magic bytes, - 32-bit ARM architecture, file size (must match the original), and archive integrity are - all checked. If anything looks wrong, the build fails with an error. That said, both - NickelMenu and custom patches modify system files, so you should know how to - manually reset your Kobo - if needed. -

+ +

If you would like to better understand how these various components work, I recommend reading through the README files of this project, NickelMenu and kobopatch, all of which are linked in the footer.

@@ -445,7 +428,9 @@
  • How the flow was started — whether you connected a Kobo directly or chose the manual download option. This helps the author decide whether to keep the manual download option, or remove it (if it is barely used).
  • Which NickelMenu option was selected — preset installation, - NickelMenu only, or removal.
    • + NickelMenu only, or removal. This helps the author understand which options to improve first. +
  • Which NickelMenu add-ons were selected — whether KOReader, + simplified home screen features, or the basic tab bar option were enabled. This helps the author understand which features are popular and worth maintaining.
  • How the flow ended — whether files were written to the device or downloaded as a ZIP. This helps the author understand how many people have actually used the complete flow successfully.
    • diff --git a/web/src/js/nickelmenu-flow.js b/web/src/js/nickelmenu-flow.js index 35df6cc..d9b6369 100644 --- a/web/src/js/nickelmenu-flow.js +++ b/web/src/js/nickelmenu-flow.js @@ -374,6 +374,12 @@ export function initNickelMenu(state) { // Install flow: either write directly to device or build a ZIP for download. const features = state.nickelMenuOption === 'preset' ? getSelectedFeatures() : []; + const hasKOReader = features.some(f => f.id === 'koreader'); + const hasSimplifiedHome = features.some(f => f.id === 'hide-notices' || f.id === 'hide-recommendations'); + const hasBasicTabs = features.some(f => f.id === 'simplify-tabs'); + track('nm-koreader-addon', { enabled: hasKOReader ? 'yes' : 'no' }); + track('nm-simplified-home', { enabled: hasSimplifiedHome ? 'yes' : 'no' }); + track('nm-basic-tabs', { enabled: hasBasicTabs ? 'yes' : 'no' }); if (writeToDevice && state.device.directoryHandle) { await state.nmInstaller.installToDevice(state.device, features, progressFn);