uxjulia · uxjulia · Jun 25, 2026 · May 29, 2026 · May 29, 2026 · May 29, 2026
diff --git a/.agents/skills/custom-fonts/SKILL.md b/.agents/skills/custom-fonts/SKILL.md
diff --git a/.github/skills/crosspoint-reader.md b/.github/skills/crosspoint-reader.md
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -16,6 +16,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
+          token: ${{ secrets.RELEASE_PAT }}
           submodules: recursive
           fetch-depth: 0
 
@@ -61,7 +62,12 @@ jobs:
       - name: Build CrossInk
         env:
           CROSSPOINT_RELEASE_VERSION: ${{ env.RELEASE_VERSION }}
-        run: pio run -e teensy -e tiny -e xlarge -e no_emoji
+        run: pio run -e teensy -e tiny -e xlarge
+
+      - name: Create legacy no_emoji OTA alias
+        run: |
+          cp ".pio/build/tiny/firmware-tiny-v${{ env.RELEASE_VERSION }}.bin" \
+            ".pio/build/tiny/firmware-no_emoji-v${{ env.RELEASE_VERSION }}.bin"
 
       - name: Generate release catalog
         run: |
@@ -71,15 +77,28 @@ jobs:
             --firmware ".pio/build/teensy/firmware-teensy-v${{ env.RELEASE_VERSION }}.bin" \
             --firmware ".pio/build/tiny/firmware-tiny-v${{ env.RELEASE_VERSION }}.bin" \
             --firmware ".pio/build/xlarge/firmware-xlarge-v${{ env.RELEASE_VERSION }}.bin" \
-            --firmware ".pio/build/no_emoji/firmware-no_emoji-v${{ env.RELEASE_VERSION }}.bin" \
             --output ".pio/build/catalog"
 
       - name: Publish catalog to GitHub Pages source
         env:
           DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+          CROSSINK_SIGNING_SSH_KEY: ${{ secrets.CROSSINK_SIGNING_SSH_KEY }}
         run: |
+          if [ -z "$CROSSINK_SIGNING_SSH_KEY" ]; then
+            echo "::error::CROSSINK_SIGNING_SSH_KEY is not set"
+            exit 1
+          fi
+
+          install -m 700 -d ~/.ssh
+          printf '%s\n' "$CROSSINK_SIGNING_SSH_KEY" > ~/.ssh/crossink_actions_signing
+          chmod 600 ~/.ssh/crossink_actions_signing
+          ssh-keygen -y -f ~/.ssh/crossink_actions_signing > ~/.ssh/crossink_actions_signing.pub
+
           git config user.name "uxjulia"
           git config user.email "[email protected]"
+          git config gpg.format ssh
+          git config user.signingkey "$HOME/.ssh/crossink_actions_signing.pub"
+
           git fetch origin "$DEFAULT_BRANCH"
           git worktree add ../crossink-pages "origin/$DEFAULT_BRANCH"
           cp ".pio/build/catalog" "../crossink-pages/docs/catalog"
@@ -89,7 +108,7 @@ jobs:
             exit 0
           fi
           git add docs/catalog
-          git commit -m "Update release catalog for v${RELEASE_VERSION}"
+          git commit -S -m "Update release manifests for v${RELEASE_VERSION}"
           git push origin "HEAD:$DEFAULT_BRANCH"
 
       - name: Create GitHub Release
@@ -102,5 +121,5 @@ jobs:
           files: |
             .pio/build/teensy/firmware-teensy-v${{ env.RELEASE_VERSION }}.bin
             .pio/build/tiny/firmware-tiny-v${{ env.RELEASE_VERSION }}.bin
+            .pio/build/tiny/firmware-no_emoji-v${{ env.RELEASE_VERSION }}.bin
             .pio/build/xlarge/firmware-xlarge-v${{ env.RELEASE_VERSION }}.bin
-            .pio/build/no_emoji/firmware-no_emoji-v${{ env.RELEASE_VERSION }}.bin
diff --git a/.github/workflows/release_candidate.yml b/.github/workflows/release_candidate.yml
@@ -105,4 +105,3 @@ jobs:
             .pio/build/teensy/firmware-teensy-${{ env.RC_BRANCH_SAFE }}-${{ env.RC_HASH_SHORT }}-RC.bin
             .pio/build/tiny/firmware-tiny-${{ env.RC_BRANCH_SAFE }}-${{ env.RC_HASH_SHORT }}-RC.bin
             .pio/build/xlarge/firmware-xlarge-${{ env.RC_BRANCH_SAFE }}-${{ env.RC_HASH_SHORT }}-RC.bin
-            .pio/build/no_emoji/firmware-no_emoji-${{ env.RC_BRANCH_SAFE }}-${{ env.RC_HASH_SHORT }}-RC.bin
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,40 @@
 # Changelog
+## [v1.3.4] - 2026-06-24
+
+### Added
+- File Browser now indexes large SD-card folders so directories with many books can be browsed without loading every filename into memory at once.
+- EPUB text clipping with saved highlights, clipping lists, and Kindle-style `/My Clippings.txt` export.
+- `Create Clipping` is now available as a reader shortcut for short/long Power, long-press Menu, and long-press Back actions.
+- Per-book EPUB options for font, layout, styling, reading aids, and render modes, including `CrossInk Default`, `Balanced`, and `Light` modes for difficult books.
+- Arena allocator (`lib/Memory/Arena.h`) for burst-then-discard allocation patterns - reduces heap fragmentation during EPUB parsing and page layout over long reading sessions.
+- Optimized EPUBs now store location metadata at `META-INF/x-locations.json`.
+- X3 SD-card writes now use the RTC for file timestamps when the clock is available.
+
+### Changed
+- The EPUB reader menu now splits the growing menu into 3 screens, labels per-book settings as `Book Options`, and avoids showing duplicate `Orientation` controls.
+- The `Inverted` sleep cover filter now flips Minimal and Reading Stats sleep screens to black text on a white background.
+
+### Fixed
+- Calibre Wireless transfer status no longer stacks the last received-file message on top of the upload percentage.
+- X3 Tilt Direction now labels left/right choices as `Left-Right` and `Right-Left`, with existing left/right preferences migrated to keep the same physical tilt behavior.
+- EPUB layout now honors publisher page-break CSS, avoids stretching justified spaces before closing punctuation, and keeps large CSS rule sets in a smaller disk-backed lookup cache.
+- EPUB first-open conversion now uses more compact OPF manifest lookups and streams cover-wrapper parsing to avoid large temporary heap buffers on books with huge manifests.
+- EPUB chapters that run out of memory now retry with `Balanced`, `Light`, and final `Safe Mode` rendering before showing an error, apply the same fallbacks during next-chapter pre-indexing, and let book action menus reset a book's reader settings if Safe Mode still cannot open it.
+- EPUB reader font-size changes now restore the current chapter position by content instead of jumping far backward after re-indexing.
+- Reading Stats now use the reader's last live book time-left estimate instead of showing a separate fallback estimate.
+- Per-book reading stats now migrate compatible legacy `stats.bin` files into the `stats_v5.bin` flow instead of resetting when only the old filename exists.
+- Lyra Carousel Home menu rendering now avoids extra label allocations that could crash builds under low memory.
+- Lyra Carousel Home cover refresh no longer risks a reboot when memory is tight after returning to or selecting a recent book.
+- EPUB image-heavy chapters no longer risk a reboot while saving their reading cache under low memory.
+- TXT readers now stay open when pressing a page-turn button at the end of the file.
+- Long-press reader shortcuts that open another screen no longer close or confirm it again when releasing the shortcut button.
+- RoundedRaff's header battery icon and percentage now sit lower to avoid clipping at the top edge.
+- Lyra Carousel now keeps the Home header current when rendering the menu or restoring cached carousel frames, preventing stale battery and clock values while navigating between books.
+- Web file manager multi-delete now handles larger selections without failing after a small batch.
+- Portuguese EPUBs now use Portuguese hyphenation rules instead of leaving long words unhyphenated when Hyphenation is enabled.
+- Progressive JPEG EPUB covers now render more smoothly in generated cover and thumbnail BMP assets.
+- EPUB section layout now flushes long text runs earlier when Bionic Reading or Guide Dots are enabled, reducing low-memory failures on difficult books.
+- Footnotes in EPUBs with very large shared notes sections no longer cause long stalls when opened.
 
 ## [v1.3.3] - 2026-06-13
 

diff --git a/README.md b/README.md
@@ -67,7 +67,7 @@ The UI now uses [Inter](https://fonts.google.com/specimen/Inter) as the display
 
 ### Font Sizes
 
-There are 4 available build variants to choose from due to build size constraints: `teensy`, `tiny`, `xlarge`, and `no_emoji`.
+There are 3 available build variants to choose from due to build size constraints: `teensy`, `tiny`, and `xlarge`.
 
 See [Font Build Variants](./docs/font-build-variants.md) for the full point-size and emoji-support matrix.
 

diff --git a/USER_GUIDE.md b/USER_GUIDE.md
@@ -530,6 +530,8 @@ On the **Xteink X3**, the gyroscope can be used to turn pages by tilting the dev
 
 When reading an EPUB that contains footnotes, you can navigate to the footnote text by selecting the footnote reference in the book. From the footnote, you can return to your original reading position.
 
+If the device goes to sleep or you close the book while viewing a footnote, the book reopens to your original reading position, not the footnote.
+
 ### System Navigation
 
 * **Return to Home:** Press the **Back** button to close the book and return to the **[Home](#31-home-screen)** screen.

diff --git a/docs/catalog b/docs/catalog
@@ -1,69 +1,69 @@
 {
-  "schema_version": 1,
-  "releases": [
-    {
-      "id": "stable-1.3.3-teensy",
-      "channel": "stable",
-      "name": "1.3.3",
-      "version": "1.3.3",
-      "variant": "teensy",
-      "released_at": "2026-06-13T20:06:21Z",
-      "notes": "CrossInk 1.3.3 stable firmware",
-      "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-teensy-v1.3.3.bin",
-      "firmware_sha256": "4dbff2a0361d77d820860f7d937e22ef0b3ba14840b17f82a95395c28b63389d",
-      "size": 5752432,
-      "supported_devices": [
-        "x4",
-        "x3"
+      "schema_version": 1,
+      "releases": [
+            {
+                  "id": "stable-1.3.3-teensy",
+                  "channel": "stable",
+                  "name": "1.3.3",
+                  "version": "1.3.3",
+                  "variant": "teensy",
+                  "released_at": "2026-06-13T20:06:21Z",
+                  "notes": "CrossInk 1.3.3 stable firmware",
+                  "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-teensy-v1.3.3.bin",
+                  "firmware_sha256": "4dbff2a0361d77d820860f7d937e22ef0b3ba14840b17f82a95395c28b63389d",
+                  "size": 5752432,
+                  "supported_devices": [
+                        "x4",
+                        "x3"
+                  ]
+            },
+            {
+                  "id": "stable-1.3.3-tiny",
+                  "channel": "stable",
+                  "name": "1.3.3",
+                  "version": "1.3.3",
+                  "variant": "tiny",
+                  "released_at": "2026-06-13T20:06:21Z",
+                  "notes": "CrossInk 1.3.3 stable firmware",
+                  "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-tiny-v1.3.3.bin",
+                  "firmware_sha256": "ccaed6bdd7cd0282f1a5c3aaf47c5a4d1344777cc7604c854687cfcf38cc1164",
+                  "size": 6186384,
+                  "supported_devices": [
+                        "x4",
+                        "x3"
+                  ]
+            },
+            {
+                  "id": "stable-1.3.3-xlarge",
+                  "channel": "stable",
+                  "name": "1.3.3",
+                  "version": "1.3.3",
+                  "variant": "xlarge",
+                  "released_at": "2026-06-13T20:06:21Z",
+                  "notes": "CrossInk 1.3.3 stable firmware",
+                  "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-xlarge-v1.3.3.bin",
+                  "firmware_sha256": "6d2b4dcc5d5b5adfdbc8dc450ff5676c3976705737e6400597d9d5dd21bf2528",
+                  "size": 6050896,
+                  "supported_devices": [
+                        "x4",
+                        "x3"
+                  ]
+            },
+            {
+                  "id": "stable-1.3.3-no_emoji",
+                  "channel": "stable",
+                  "name": "1.3.3",
+                  "version": "1.3.3",
+                  "variant": "no_emoji",
+                  "released_at": "2026-06-13T20:06:21Z",
+                  "notes": "CrossInk 1.3.3 stable firmware",
+                  "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-no_emoji-v1.3.3.bin",
+                  "firmware_sha256": "083b49bd99b744edeb42677dd01e34f7e059753e834de9860aa332af43098521",
+                  "size": 6509856,
+                  "supported_devices": [
+                        "x4",
+                        "x3"
+                  ]
+            }
       ]
-    },
-    {
-      "id": "stable-1.3.3-tiny",
-      "channel": "stable",
-      "name": "1.3.3",
-      "version": "1.3.3",
-      "variant": "tiny",
-      "released_at": "2026-06-13T20:06:21Z",
-      "notes": "CrossInk 1.3.3 stable firmware",
-      "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-tiny-v1.3.3.bin",
-      "firmware_sha256": "ccaed6bdd7cd0282f1a5c3aaf47c5a4d1344777cc7604c854687cfcf38cc1164",
-      "size": 6186384,
-      "supported_devices": [
-        "x4",
-        "x3"
-      ]
-    },
-    {
-      "id": "stable-1.3.3-xlarge",
-      "channel": "stable",
-      "name": "1.3.3",
-      "version": "1.3.3",
-      "variant": "xlarge",
-      "released_at": "2026-06-13T20:06:21Z",
-      "notes": "CrossInk 1.3.3 stable firmware",
-      "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-xlarge-v1.3.3.bin",
-      "firmware_sha256": "6d2b4dcc5d5b5adfdbc8dc450ff5676c3976705737e6400597d9d5dd21bf2528",
-      "size": 6050896,
-      "supported_devices": [
-        "x4",
-        "x3"
-      ]
-    },
-    {
-      "id": "stable-1.3.3-no_emoji",
-      "channel": "stable",
-      "name": "1.3.3",
-      "version": "1.3.3",
-      "variant": "no_emoji",
-      "released_at": "2026-06-13T20:06:21Z",
-      "notes": "CrossInk 1.3.3 stable firmware",
-      "firmware_url": "https://github.com/uxjulia/CrossInk/releases/latest/download/firmware-no_emoji-v1.3.3.bin",
-      "firmware_sha256": "083b49bd99b744edeb42677dd01e34f7e059753e834de9860aa332af43098521",
-      "size": 6509856,
-      "supported_devices": [
-        "x4",
-        "x3"
-      ]
-    }
-  ]
-}
+}
diff --git a/docs/contributing/development-workflow.md b/docs/contributing/development-workflow.md
@@ -34,7 +34,7 @@ pio run -e default
 CI enforces formatting, static analysis, and the primary firmware build.
 Use clang-format 21+ locally to match CI.
 If `clang-format` is missing or too old locally, see [Getting Started](./getting-started.md).
-Run plain `pio run` before larger PRs to build the release variants (`teensy`, `tiny`, `xlarge`, and `no_emoji`).
+Run plain `pio run` before larger PRs to build the release variants (`teensy`, `tiny`, and `xlarge`).
 
 ## 4) Open the PR
 

diff --git a/docs/contributing/getting-started.md b/docs/contributing/getting-started.md
@@ -73,7 +73,7 @@ pio run -e simulator
 pio run -e default
 ```
 
-`pio run` without an environment builds the release variants listed in `platformio.ini`: `teensy`, `tiny`, `xlarge`, and `no_emoji`.
+`pio run` without an environment builds the release variants listed in `platformio.ini`: `teensy`, `tiny`, and `xlarge`.
 
 ## Flash
 

diff --git a/docs/contributing/testing-debugging.md b/docs/contributing/testing-debugging.md
@@ -20,7 +20,7 @@ pio run -e simulator
 pio run -e default
 ```
 
-`pio run` without `-e` builds the release matrix from `platformio.ini` (`teensy`, `tiny`, `xlarge`, and `no_emoji`). Use it before opening broad firmware PRs, but prefer explicit environments while iterating.
+`pio run` without `-e` builds the release matrix from `platformio.ini` (`teensy`, `tiny`, and `xlarge`). Use it before opening broad firmware PRs, but prefer explicit environments while iterating.
 
 ## Flash and monitor
 

diff --git a/docs/data-cache.md b/docs/data-cache.md
@@ -27,12 +27,14 @@ The main data directory is `.crosspoint` on the SD card. It stores render caches
 ├── opds.json               # Saved OPDS servers
 ├── koreader.json           # KOReader sync credentials
 ├── bookmarks/              # Bookmark files, one per book
+├── clippings/              # EPUB clipping/highlight files, one per book
 ├── home_carousel_cache.bin # Lyra Carousel home-screen snapshot cache
 ├── sleep_frame.bin         # Temporary sleep overlay framebuffer, when used
 ├── epub_12471232/          # Each EPUB is cached to epub_<hash>
 │   ├── progress.bin        # Reading position (chapter, page, etc.)
-│   ├── stats.bin           # Per-book reading stats
-│   ├── reader_settings.bin # Per-book reader settings
+│   ├── stats.bin           # Legacy per-book reading stats
+│   ├── stats_v5.bin        # Version 5 per-book reading stats
+│   ├── reader_settings.bin # Per-book reader settings, render mode, and auto-page-turn interval
 │   ├── cover.bmp           # Book cover image, once generated
 │   ├── thumb_*.bmp         # Home/recent-books thumbnail images
 │   ├── book.bin            # Book metadata, spine, table of contents, etc.
@@ -57,6 +59,17 @@ To clear EPUB/XTC render caches from the device UI without deleting settings or
 
 Cache folders are path-based. Moving a book file can create a new cache directory, so the moved copy may start with fresh reading progress unless the firmware migrates the cache for that move. CrossInk migrates cache and bookmark data for the built-in move-to-Read flow and related file-browser move actions.
 
+EPUB reader font, page layout, styling, and reading-aid settings normally come from the global Reader settings. If those settings are changed from inside an EPUB, CrossInk stores a per-book override in that book's `reader_settings.bin`; books without that override continue to follow the global defaults. EPUB render mode is also stored per book so a problematic title can be switched to Balanced or Light rendering from the File Browser or Recent Books long-press menus before opening it.
+
+EPUB clippings and highlights live outside the EPUB render-cache folder in
+`/.crosspoint/clippings/`. Each book gets a binary clipping file named from the
+book type and the CRC32 of the book path. The same clipping record powers the
+in-reader highlight, the clipping list, and jump-back behavior. CrossInk also
+appends a Kindle-style text export to `/My Clippings.txt` on the SD-card root;
+that export is human-readable and append-only, so deleting a clipping in the UI
+removes the in-app saved clipping but does not rewrite old text already exported
+to `/My Clippings.txt`.
+
 Cache data is cleared by supported CrossInk delete/move flows. If you remove or rename books outside CrossInk by editing the SD card directly, old cache folders may remain until you clear reading cache.
 
 All-time reading stats can also be backed up outside `.crosspoint` in: