komado 0.1.0 → 0.1.2

package/README.md

@@ -41,7 +41,8 @@ with [Ink](https://github.com/vadimdemedes/ink).
 
 ## Install
 
-One line — fetches the latest, builds it, and drops a `komado` launcher on your PATH:
+**macOS / Linux** — one line fetches the latest, builds it, and drops a `komado`
+launcher on your PATH:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/RyuPrad/komado/main/install.sh | bash
@@ -51,8 +52,26 @@ Then just type **`komado`**. Re-run that same command any time to update. It nee
 `git`, **Node ≥ 20**, and `npm`; it installs to `~/.local/share/komado` with the
 launcher in `~/.local/bin` (override via `KOMADO_APP_DIR` / `KOMADO_BIN_DIR`).
 
-Uninstall: `rm -rf ~/.local/share/komado ~/.local/bin/komado` (add `~/.komado` to also
-drop your saved progress and login).
+**Windows** — the PowerShell one-liner installs Node.js for you (via `winget`) if it's
+missing, then komado, leaving a native `komado` command on your `PATH`:
+
+```powershell
+irm https://raw.githubusercontent.com/RyuPrad/komado/main/install.ps1 | iex
+```
+
+Already have **Node ≥ 20**? Install straight from PowerShell or CMD instead:
+
+```powershell
+npm i -g komado
+```
+
+Don't use the `curl … | bash` line on Windows — under **Git Bash** or **WSL** it
+installs a launcher that only runs inside that shell, never from CMD/PowerShell.
+
+Uninstall from inside the app — **Settings → Uninstall komado…** (type `uninstall` to
+confirm) — removes the app, its launcher, and `~/.komado` (config, reading progress,
+MangaDex login). By hand that's
+`rm -rf ~/.local/share/komado ~/.local/bin/komado ~/.komado`.
 
 ### From source (for development)
 
@@ -97,7 +116,7 @@ Readable text needs real pixels. At startup the app probes your terminal (run
 - **sixel or kitty graphics supported** → opening a chapter launches a
   full-resolution **pixel viewer** (chafa straight to the terminal). It renders
   full-width with vertical pan by default; press `f` to toggle whole-page fit.
-  Keys: `←`/`→` or `a`/`d` page · `↑`/`↓` pan · `N`/`P` chapter · `f` fit · `q` back.
+  Keys: `←`/`→` or `a`/`d` page · `↑`/`↓` pan · `n`/`p` chapter · `f` fit · `q` back.
 - **neither** → the in-Ink **cell reader** is used (Unicode half-blocks, or
   chafa symbols when available). Fine for art, coarse for small lettering —
   that's the hard ceiling of character-cell rendering.

package/dist/components/screens/ReaderScreen.js

@@ -155,12 +155,12 @@ function ReaderScreen({ params }) {
       if (scroll >= maxScroll) nextPage();
       else setScroll((s) => Math.min(maxScroll, s + viewportRows - 1));
     } else if (key.pageUp) setScroll((s) => Math.max(0, s - (viewportRows - 1)));
-    else if (key.rightArrow || input === "l" || input === "n") nextPage();
-    else if (key.leftArrow || input === "h" || input === "p") prevPage();
+    else if (key.rightArrow || input === "l") nextPage();
+    else if (key.leftArrow || input === "h") prevPage();
     else if (input === "g") setScroll(0);
     else if (input === "G") setScroll(maxScroll);
-    else if (input === "N") changeChapter(1);
-    else if (input === "P") changeChapter(-1);
+    else if (input === "n" || input === "N") changeChapter(1);
+    else if (input === "p" || input === "P") changeChapter(-1);
     else if (input === "f") setFitMode((f) => !f);
     else if (input === "r") cycleRenderer();
   });
@@ -173,7 +173,7 @@ function ReaderScreen({ params }) {
     ] }),
     /* @__PURE__ */ jsx(Box, { height: viewportRows, flexDirection: "column", children: status === "loading" ? /* @__PURE__ */ jsx(Spinner, { label: pages ? `Rendering page ${pageIndex + 1}` : "Loading chapter" }) : status === "error" ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx(ErrorView, { error }),
-      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Press N / P to skip to another chapter, or Esc to go back." })
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Press n / p to skip to another chapter, or Esc to go back." })
     ] }) : slice.map((ln, i) => /* @__PURE__ */ jsx(Text, { wrap: "truncate-end", children: ln }, scroll + i)) }),
     /* @__PURE__ */ jsx(
       KeyHints,
@@ -181,7 +181,7 @@ function ReaderScreen({ params }) {
         hints: [
           ["\u2190\u2192", "page"],
           ["\u2191\u2193", "scroll"],
-          ["N/P", "chapter"],
+          ["n/p", "chapter"],
           ["f", fitMode ? "scroll" : "fit"],
           ["r", `render:${rendererPref}`],
           ["esc", "back"]

package/dist/components/screens/SettingsScreen.js

@@ -10,6 +10,7 @@ import { detectCapabilities } from "../../render/detect.js";
 import { List } from "../List.js";
 import { Header, KeyHints } from "../ui.js";
 import { truncate } from "../../lib/text.js";
+import { performUninstall, uninstallTargets, displayPath, formatUninstallSummary } from "../../uninstall.js";
 const RENDERERS = ["auto", "halfblock", "chafa"];
 const RATING_PRESETS = [
   ["safe"],
@@ -52,7 +53,8 @@ function SettingsScreen() {
       pathIndex: i,
       label: `Library: ${truncate(p, 48)}`,
       value: "d to remove"
-    }))
+    })),
+    { id: "uninstall", kind: "danger", label: "Uninstall komado\u2026", value: "removes the app + all data" }
   ];
   const activate = (item) => {
     switch (item.kind) {
@@ -78,11 +80,27 @@ function SettingsScreen() {
       case "action":
         setDraft("");
         return setEditing("addPath");
+      case "danger":
+        setDraft("");
+        return setEditing("uninstall");
       default:
         return void 0;
     }
   };
   const submitEdit = () => {
+    if (editing === "uninstall") {
+      if (draft.trim().toLowerCase() === "uninstall") {
+        const results = performUninstall();
+        process.once("exit", () => process.stdout.write(`
+${formatUninstallSummary(results)}
+`));
+        ui.exit();
+        return;
+      }
+      setEditing(null);
+      setDraft("");
+      return;
+    }
     if (editing === "language") {
       save({ language: draft.trim() || "en" });
     } else if (editing === "addPath" && draft.trim()) {
@@ -113,7 +131,21 @@ function SettingsScreen() {
         subtitle: `chafa: ${caps.chafa ? caps.chafaVersion : "not installed"} \xB7 backend: ${caps.chafa ? "chafa-symbols" : "half-block"}`
       }
     ),
-    editing ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    editing === "uninstall" ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx(Text, { color: "redBright", bold: true, children: "\u26A0  Uninstall komado" }),
+      /* @__PURE__ */ jsx(Text, { children: "This permanently deletes:" }),
+      uninstallTargets().map((t) => /* @__PURE__ */ jsxs(Text, { color: "red", children: [
+        `  \u2022 ${displayPath(t.path)}`,
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  \u2014 ${t.label}` })
+      ] }, t.path)),
+      /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx(Text, { children: "Type " }),
+        /* @__PURE__ */ jsx(Text, { color: "redBright", bold: true, children: "uninstall" }),
+        /* @__PURE__ */ jsx(Text, { children: " to confirm: " }),
+        /* @__PURE__ */ jsx(TextInput, { value: draft, onChange: setDraft, onSubmit: submitEdit, focus: true })
+      ] }),
+      /* @__PURE__ */ jsx(KeyHints, { hints: [["enter", "confirm"], ["esc", "cancel"]] })
+    ] }) : editing ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx(Text, { color: "cyanBright", children: editing === "addPath" ? "New library path (folder of manga / CBZ):" : "Language code (e.g. en, fr, ja):" }),
       /* @__PURE__ */ jsxs(Box, { children: [
         /* @__PURE__ */ jsx(Text, { color: "cyanBright", children: "\u203A " }),
@@ -130,7 +162,7 @@ function SettingsScreen() {
           onSelect: activate,
           onHighlight: (it) => setHighlighted(it),
           renderItem: (it, active) => /* @__PURE__ */ jsxs(Box, { justifyContent: "space-between", children: [
-            /* @__PURE__ */ jsx(Text, { inverse: active, color: active ? "cyanBright" : it.kind === "path" ? "blue" : void 0, children: ` ${it.label} ` }),
+            /* @__PURE__ */ jsx(Text, { inverse: active, color: active ? "cyanBright" : it.kind === "danger" ? "red" : it.kind === "path" ? "blue" : void 0, children: ` ${it.label} ` }),
             it.value ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: it.value }) : null
           ] }, it.id)
         }

package/dist/sixel-reader.js

@@ -68,7 +68,7 @@ async function runViewer({ sourceId, manga, chapters, chapterIndex, startPage =
   function statusBar() {
     const { cols } = size();
     const left = `${manga.title} \xB7 ${chapterLabel(chapters[ci])} \xB7 ${pi + 1}/${pages ? pages.length : "?"}${fitWidth ? "" : " \xB7 fit"}`;
-    const right = "\u2190\u2192 page \xB7 \u2191\u2193 pan \xB7 N/P ch \xB7 f fit \xB7 q back";
+    const right = "\u2190\u2192 page \xB7 \u2191\u2193 pan \xB7 n/p ch \xB7 f fit \xB7 q back";
     const gap = Math.max(1, cols - left.length - right.length - 2);
     return ` ${left}${" ".repeat(gap)}${right} `.slice(0, cols);
   }
@@ -152,7 +152,7 @@ async function runViewer({ sourceId, manga, chapters, chapterIndex, startPage =
         chapterNumber: chapters[ci].number,
         page: pi
       });
-      if (pi === pages.length - 1 && source.syncChapterRead) {
+      if (pages && pi === pages.length - 1 && source.syncChapterRead) {
         source.syncChapterRead(manga.id, chapters[ci].id);
       }
     } catch (err) {
@@ -160,7 +160,7 @@ async function runViewer({ sourceId, manga, chapters, chapterIndex, startPage =
       stdout.write(`${ESC}[2J${ESC}[H${ESC}[0m`);
       stdout.write(`Error: ${err.message}\r
 \r
-N/P chapter \xB7 q back\r
+n/p chapter \xB7 q back\r
 `);
     }
   }
@@ -250,12 +250,9 @@ N/P chapter \xB7 q back\r
           resolve();
           return;
         }
-        if (k === "n" || k === " ") {
+        if (k === " ") {
           if (fitWidth && scroll < maxScroll) scroll = Math.min(maxScroll, scroll + pageStep);
           else nextPage();
-        } else if (k === "p") {
-          if (fitWidth && scroll > 0) scroll = Math.max(0, scroll - pageStep);
-          else prevPage();
         } else if (k === "d" || k === `${ESC}[C`) {
           nextPage();
         } else if (k === "a" || k === `${ESC}[D`) {
@@ -264,9 +261,9 @@ N/P chapter \xB7 q back\r
           scroll = Math.min(maxScroll, scroll + scrollStep);
         } else if (k === "k" || k === `${ESC}[A`) {
           scroll = Math.max(0, scroll - scrollStep);
-        } else if (k === "N") {
+        } else if (k === "n" || k === "N") {
           changeChapter(1);
-        } else if (k === "P") {
+        } else if (k === "p" || k === "P") {
           changeChapter(-1);
         } else if (k === "f") {
           fitWidth = !fitWidth;

package/dist/state/store.js

@@ -9,7 +9,13 @@ function readJson(file, fallback) {
     return fallback;
   }
 }
+let persistenceDisabled = false;
+function disablePersistence() {
+  persistenceDisabled = true;
+  clearTimeout(saveTimer);
+}
 function writeJsonAtomic(file, data) {
+  if (persistenceDisabled) return;
   ensureDirs();
   const tmp = `${file}.${process.pid}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(data, null, 2));
@@ -32,6 +38,7 @@ function loadProgress() {
 }
 let saveTimer = null;
 function scheduleSave() {
+  if (persistenceDisabled) return;
   clearTimeout(saveTimer);
   saveTimer = setTimeout(() => writeJsonAtomic(paths.progressFile, progress), 400);
   saveTimer.unref?.();
@@ -52,6 +59,7 @@ function flushProgress() {
 }
 let credentials = null;
 function writeCredentialsAtomic(data) {
+  if (persistenceDisabled) return;
   ensureDirs();
   const file = paths.credentialsFile;
   const tmp = `${file}.${process.pid}.tmp`;
@@ -80,6 +88,7 @@ function clearCredentials() {
 }
 export {
   clearCredentials,
+  disablePersistence,
   flushProgress,
   getAllProgress,
   getConfig,

package/dist/uninstall.js

@@ -0,0 +1,58 @@
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import { paths } from "./config.js";
+import { disablePersistence } from "./state/store.js";
+function appDir() {
+  if (process.env.KOMADO_APP_DIR) return path.resolve(process.env.KOMADO_APP_DIR);
+  const share = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
+  return path.join(share, "komado");
+}
+function launcherFile() {
+  const bin = process.env.KOMADO_BIN_DIR ? path.resolve(process.env.KOMADO_BIN_DIR) : path.join(os.homedir(), ".local", "bin");
+  return path.join(bin, "komado");
+}
+function uninstallTargets() {
+  return [
+    { label: "application files", path: appDir() },
+    { label: "launcher", path: launcherFile() },
+    { label: "config, reading progress & MangaDex login", path: paths.home }
+  ];
+}
+function displayPath(p) {
+  const home = os.homedir();
+  if (p === home) return "~";
+  return p.startsWith(home + path.sep) ? `~${p.slice(home.length)}` : p;
+}
+function assertSafe(p) {
+  const resolved = path.resolve(p);
+  if (!resolved || resolved === path.parse(resolved).root || resolved === os.homedir()) {
+    throw new Error(`refusing to delete unsafe path: ${resolved}`);
+  }
+}
+function performUninstall() {
+  disablePersistence();
+  return uninstallTargets().map((t) => {
+    try {
+      assertSafe(t.path);
+      const existed = fs.existsSync(t.path);
+      fs.rmSync(t.path, { recursive: true, force: true });
+      return { ...t, status: existed ? "removed" : "absent" };
+    } catch (err) {
+      return { ...t, status: "failed", error: err.message };
+    }
+  });
+}
+function formatUninstallSummary(results) {
+  const ok = results.every((r) => r.status !== "failed");
+  const tag = { removed: "removed", absent: "absent ", failed: "FAILED " };
+  const lines = results.map((r) => `  ${tag[r.status]}  ${displayPath(r.path)}${r.error ? `  (${r.error})` : ""}`);
+  const head = ok ? "komado has been uninstalled." : "komado uninstall finished with errors.";
+  return [head, "", ...lines, ""].join("\n");
+}
+export {
+  displayPath,
+  formatUninstallSummary,
+  performUninstall,
+  uninstallTargets
+};

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "komado",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A terminal manga reader (MangaDex + local files) rendered with Ink.",
-  "keywords": ["manga", "mangadex", "reader", "terminal", "tui", "cli", "sixel", "cbz", "comic"],
+  "keywords": [
+    "manga",
+    "mangadex",
+    "reader",
+    "terminal",
+    "tui",
+    "cli",
+    "sixel",
+    "cbz",
+    "comic"
+  ],
   "type": "module",
   "bin": {
     "komado": "dist/cli.js"
@@ -26,7 +36,10 @@
     "node": ">=20"
   },
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/RyuPrad/komado.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RyuPrad/komado.git"
+  },
   "homepage": "https://github.com/RyuPrad/komado#readme",
   "bugs": "https://github.com/RyuPrad/komado/issues",
   "dependencies": {

package/src/components/screens/ReaderScreen.js

@@ -179,12 +179,12 @@ export function ReaderScreen({ params }) {
       if (scroll >= maxScroll) nextPage();
       else setScroll((s) => Math.min(maxScroll, s + viewportRows - 1));
     } else if (key.pageUp) setScroll((s) => Math.max(0, s - (viewportRows - 1)));
-    else if (key.rightArrow || input === 'l' || input === 'n') nextPage();
-    else if (key.leftArrow || input === 'h' || input === 'p') prevPage();
+    else if (key.rightArrow || input === 'l') nextPage();
+    else if (key.leftArrow || input === 'h') prevPage();
     else if (input === 'g') setScroll(0);
     else if (input === 'G') setScroll(maxScroll);
-    else if (input === 'N') changeChapter(1);
-    else if (input === 'P') changeChapter(-1);
+    else if (input === 'n' || input === 'N') changeChapter(1);
+    else if (input === 'p' || input === 'P') changeChapter(-1);
     else if (input === 'f') setFitMode((f) => !f);
     else if (input === 'r') cycleRenderer();
   });
@@ -206,7 +206,7 @@ export function ReaderScreen({ params }) {
         ) : status === 'error' ? (
           <Box flexDirection="column">
             <ErrorView error={error} />
-            <Text dimColor>Press N / P to skip to another chapter, or Esc to go back.</Text>
+            <Text dimColor>Press n / p to skip to another chapter, or Esc to go back.</Text>
           </Box>
         ) : (
           slice.map((ln, i) => (
@@ -219,7 +219,7 @@ export function ReaderScreen({ params }) {
         hints={[
           ['←→', 'page'],
           ['↑↓', 'scroll'],
-          ['N/P', 'chapter'],
+          ['n/p', 'chapter'],
           ['f', fitMode ? 'scroll' : 'fit'],
           ['r', `render:${rendererPref}`],
           ['esc', 'back'],

package/src/components/screens/SettingsScreen.js

@@ -9,6 +9,7 @@ import { detectCapabilities } from '../../render/detect.js';
 import { List } from '../List.js';
 import { Header, KeyHints } from '../ui.js';
 import { truncate } from '../../lib/text.js';
+import { performUninstall, uninstallTargets, displayPath, formatUninstallSummary } from '../../uninstall.js';
 
 const RENDERERS = ['auto', 'halfblock', 'chafa'];
 const RATING_PRESETS = [
@@ -50,6 +51,7 @@ export function SettingsScreen() {
     ...cfg.localLibraryPaths.map((p, i) => ({
       id: `path:${i}`, kind: 'path', pathIndex: i, label: `Library: ${truncate(p, 48)}`, value: 'd to remove',
     })),
+    { id: 'uninstall', kind: 'danger', label: 'Uninstall komado…', value: 'removes the app + all data' },
   ];
 
   const activate = (item) => {
@@ -73,12 +75,29 @@ export function SettingsScreen() {
       case 'action':
         setDraft('');
         return setEditing('addPath');
+      case 'danger':
+        setDraft('');
+        return setEditing('uninstall');
       default:
         return undefined;
     }
   };
 
   const submitEdit = () => {
+    if (editing === 'uninstall') {
+      // Only the exact word commits. performUninstall() disables persistence and
+      // deletes everything; we register a goodbye to print AFTER Ink tears the
+      // alt-screen down (cli.js's restore runs first), then quit.
+      if (draft.trim().toLowerCase() === 'uninstall') {
+        const results = performUninstall();
+        process.once('exit', () => process.stdout.write(`\n${formatUninstallSummary(results)}\n`));
+        ui.exit();
+        return;
+      }
+      setEditing(null);
+      setDraft('');
+      return;
+    }
     if (editing === 'language') {
       save({ language: draft.trim() || 'en' });
     } else if (editing === 'addPath' && draft.trim()) {
@@ -110,7 +129,25 @@ export function SettingsScreen() {
         subtitle={`chafa: ${caps.chafa ? caps.chafaVersion : 'not installed'} · backend: ${caps.chafa ? 'chafa-symbols' : 'half-block'}`}
       />
 
-      {editing ? (
+      {editing === 'uninstall' ? (
+        <Box flexDirection="column">
+          <Text color="redBright" bold>{'⚠  Uninstall komado'}</Text>
+          <Text>This permanently deletes:</Text>
+          {uninstallTargets().map((t) => (
+            <Text key={t.path} color="red">
+              {`  • ${displayPath(t.path)}`}
+              <Text dimColor>{`  — ${t.label}`}</Text>
+            </Text>
+          ))}
+          <Box marginTop={1}>
+            <Text>{'Type '}</Text>
+            <Text color="redBright" bold>uninstall</Text>
+            <Text>{' to confirm: '}</Text>
+            <TextInput value={draft} onChange={setDraft} onSubmit={submitEdit} focus={true} />
+          </Box>
+          <KeyHints hints={[['enter', 'confirm'], ['esc', 'cancel']]} />
+        </Box>
+      ) : editing ? (
         <Box flexDirection="column">
           <Text color="cyanBright">
             {editing === 'addPath' ? 'New library path (folder of manga / CBZ):' : 'Language code (e.g. en, fr, ja):'}
@@ -131,7 +168,7 @@ export function SettingsScreen() {
             onHighlight={(it) => setHighlighted(it)}
             renderItem={(it, active) => (
               <Box key={it.id} justifyContent="space-between">
-                <Text inverse={active} color={active ? 'cyanBright' : it.kind === 'path' ? 'blue' : undefined}>
+                <Text inverse={active} color={active ? 'cyanBright' : it.kind === 'danger' ? 'red' : it.kind === 'path' ? 'blue' : undefined}>
                   {` ${it.label} `}
                 </Text>
                 {it.value ? <Text dimColor>{it.value}</Text> : null}

package/src/sixel-reader.js

@@ -106,7 +106,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
   function statusBar() {
     const { cols } = size();
     const left = `${manga.title} · ${chapterLabel(chapters[ci])} · ${pi + 1}/${pages ? pages.length : '?'}${fitWidth ? '' : ' · fit'}`;
-    const right = '←→ page · ↑↓ pan · N/P ch · f fit · q back';
+    const right = '←→ page · ↑↓ pan · n/p ch · f fit · q back';
     const gap = Math.max(1, cols - left.length - right.length - 2);
     return ` ${left}${' '.repeat(gap)}${right} `.slice(0, cols);
   }
@@ -199,13 +199,16 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
         page: pi,
       });
       // Last page reached → push a read-marker to MangaDex (self-guarded/deduped).
-      if (pi === pages.length - 1 && source.syncChapterRead) {
+      // `pages &&`: a rapid n/p runs changeChapter() (pages = null) during one of
+      // this draw's awaits, after it started — guard before reading .length, or the
+      // stale tail throws "Cannot read properties of null (reading 'length')".
+      if (pages && pi === pages.length - 1 && source.syncChapterRead) {
         source.syncChapterRead(manga.id, chapters[ci].id);
       }
     } catch (err) {
       logger.warn('viewer draw failed', err);
       stdout.write(`${ESC}[2J${ESC}[H${ESC}[0m`);
-      stdout.write(`Error: ${err.message}\r\n\r\nN/P chapter · q back\r\n`);
+      stdout.write(`Error: ${err.message}\r\n\r\nn/p chapter · q back\r\n`);
     }
   }
 
@@ -303,12 +306,10 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
         const pageStep = Math.max(1, size().rows - 2);
 
         if (k === 'q' || k === ESC) { resolve(); return; }
-        if (k === 'n' || k === ' ') {
+        if (k === ' ') {
+          // space = read-through: scroll a full page, then advance at the bottom
           if (fitWidth && scroll < maxScroll) scroll = Math.min(maxScroll, scroll + pageStep);
           else nextPage();
-        } else if (k === 'p') {
-          if (fitWidth && scroll > 0) scroll = Math.max(0, scroll - pageStep);
-          else prevPage();
         } else if (k === 'd' || k === `${ESC}[C`) {
           nextPage();           // → / d : next page
         } else if (k === 'a' || k === `${ESC}[D`) {
@@ -317,10 +318,10 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
           scroll = Math.min(maxScroll, scroll + scrollStep);
         } else if (k === 'k' || k === `${ESC}[A`) {
           scroll = Math.max(0, scroll - scrollStep);
-        } else if (k === 'N') {
-          changeChapter(1);
-        } else if (k === 'P') {
-          changeChapter(-1);
+        } else if (k === 'n' || k === 'N') {
+          changeChapter(1);     // n / N : next chapter
+        } else if (k === 'p' || k === 'P') {
+          changeChapter(-1);    // p / P : previous chapter
         } else if (k === 'f') {
           fitWidth = !fitWidth;
           scroll = 0;

package/src/state/store.js

@@ -11,8 +11,18 @@ function readJson(file, fallback) {
   }
 }
 
+// While the app is uninstalling itself, every writer no-ops so a pending debounced
+// save (or the flushProgress() that quit() runs) can't recreate the data directory
+// we just deleted. Set once, never unset — the process is on its way out.
+let persistenceDisabled = false;
+export function disablePersistence() {
+  persistenceDisabled = true;
+  clearTimeout(saveTimer);
+}
+
 // Write-to-temp + rename so a crash mid-write never corrupts the file.
 function writeJsonAtomic(file, data) {
+  if (persistenceDisabled) return;
   ensureDirs();
   const tmp = `${file}.${process.pid}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(data, null, 2));
@@ -42,6 +52,7 @@ function loadProgress() {
 // Debounced save — the reader updates progress on every page turn, so coalesce.
 let saveTimer = null;
 function scheduleSave() {
+  if (persistenceDisabled) return;
   clearTimeout(saveTimer);
   saveTimer = setTimeout(() => writeJsonAtomic(paths.progressFile, progress), 400);
   saveTimer.unref?.();
@@ -68,6 +79,7 @@ export function flushProgress() {
 // never written to disk. File is 0600 since it holds a long-lived secret.
 let credentials = null;
 function writeCredentialsAtomic(data) {
+  if (persistenceDisabled) return;
   ensureDirs();
   const file = paths.credentialsFile;
   const tmp = `${file}.${process.pid}.tmp`;

package/src/uninstall.js

@@ -0,0 +1,75 @@
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import { paths } from './config.js';
+import { disablePersistence } from './state/store.js';
+
+// Where install.sh put things. Mirrors the installer's own defaults + env
+// overrides (KOMADO_APP_DIR / KOMADO_BIN_DIR) so an in-app uninstall targets
+// exactly what was installed — and never a dev checkout, which lives elsewhere.
+function appDir() {
+  if (process.env.KOMADO_APP_DIR) return path.resolve(process.env.KOMADO_APP_DIR);
+  const share = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+  return path.join(share, 'komado');
+}
+function launcherFile() {
+  const bin = process.env.KOMADO_BIN_DIR
+    ? path.resolve(process.env.KOMADO_BIN_DIR)
+    : path.join(os.homedir(), '.local', 'bin');
+  // The launcher FILE only — never the whole bin dir, which is shared with other tools.
+  return path.join(bin, 'komado');
+}
+
+// The three things a full install creates. `paths.home` is the runtime data dir
+// (~/.komado or KOMADO_HOME) and holds config, reading progress, the MangaDex
+// login, the page cache, and the log — all under one dir, so one delete clears it.
+export function uninstallTargets() {
+  return [
+    { label: 'application files', path: appDir() },
+    { label: 'launcher', path: launcherFile() },
+    { label: 'config, reading progress & MangaDex login', path: paths.home },
+  ];
+}
+
+// $HOME → ~ for display.
+export function displayPath(p) {
+  const home = os.homedir();
+  if (p === home) return '~';
+  return p.startsWith(home + path.sep) ? `~${p.slice(home.length)}` : p;
+}
+
+// Defensive: a recursive force-delete must never escape to a filesystem or home
+// root, however the paths above were derived.
+function assertSafe(p) {
+  const resolved = path.resolve(p);
+  if (!resolved || resolved === path.parse(resolved).root || resolved === os.homedir()) {
+    throw new Error(`refusing to delete unsafe path: ${resolved}`);
+  }
+}
+
+// Remove the installed app, its launcher, and all runtime data. Synchronous — a
+// one-shot teardown run right before exit. It first switches off the store's
+// persistence so a pending debounced save (or the flushProgress() that quit()
+// runs) can't recreate the data dir we're deleting. One failing target never
+// aborts the rest; returns a per-target status list for the goodbye summary.
+export function performUninstall() {
+  disablePersistence();
+  return uninstallTargets().map((t) => {
+    try {
+      assertSafe(t.path);
+      const existed = fs.existsSync(t.path);
+      fs.rmSync(t.path, { recursive: true, force: true });
+      return { ...t, status: existed ? 'removed' : 'absent' };
+    } catch (err) {
+      return { ...t, status: 'failed', error: err.message };
+    }
+  });
+}
+
+export function formatUninstallSummary(results) {
+  const ok = results.every((r) => r.status !== 'failed');
+  const tag = { removed: 'removed', absent: 'absent ', failed: 'FAILED ' };
+  const lines = results.map((r) => `  ${tag[r.status]}  ${displayPath(r.path)}${r.error ? `  (${r.error})` : ''}`);
+  const head = ok ? 'komado has been uninstalled.' : 'komado uninstall finished with errors.';
+  return [head, '', ...lines, ''].join('\n');
+}