Repository navigation
Mareader 0.0.7
Mareader brings unified dictionary and AI word cards, a searchable AI model
picker with cleaner provider defaults, smoother live theme and paper-blend
transitions without animation hitches, and flicker-free voice switching in
Settings › Read Aloud.
Summary
New
- Unified word lookup and AI context cards with CEFR badges, IPA pronunciation, keyboard paging, and in-place tabs.
- Searchable AI model autocomplete with keyboard navigation and a Use default address toggle for built-in providers.
- Smooth animated checkboxes across settings and menus, plus a streamlined Vocabulary shading picker.
- Live GPU theme and paper-blend transitions with background settings saving so UI animations stay fluid.
Fixes
- Eliminated animation hitches when toggling Paper blend, themes, or colours and modal flicker when switching voices.
- Kept the read-aloud player anchored cleanly along the bottom edge instead of jumping upward over popups.
- Coordinated the floating Find bar and menus so opening one automatically dismisses the other.
- Kept Windows and Linux window control icons steady on hover and aligned the API key Add row in AI settings.
What's new
- Unified Lookup and AI word cards. Offline dictionary lookups and AI
contextual explanations now share a clean card header with the headword,
part of speech, colour-matched CEFR level badge, IPA pronunciation, and
pronunciation audio button. When both dictionary and AI answers are
available, an in-place Dictionary | AI in context tab switcher lets you
flip between them without moving the card, alongside compactEN ⇄ FR
language swapping,< 1 of N >numeric entry paging (←/→keys),
pinned footer actions (+ Word list,Copy,Open in the Dictionary,
Ask again), and clearer empty-dictionary actions. - Searchable AI model picker and cleaner provider setup. In Settings ›
AI, typing in the Model field now opens a unified autocomplete dropdown with
full keyboard navigation (↑,↓,Enter,Esc), and Choose focuses
the input directly. Built-in providers now default to Use default
address, keeping endpoint URLs tucked away unless you opt to customize
them. - Animated checkboxes and streamlined Vocabulary shading. Checkboxes
across Settings and menus now animate smoothly, and Vocabulary shading
presents Mark (Highlight,Half highlight,Underline) and
Colour directly without redundant style selectors. - Zero-stall live theme and paper-blend fades. Switching base modes,
themes, film grain, or Paper blend now blends UI tokens and GPU page passes
live instead of blocking on a full-window screenshot readback, and settings
persistence runs off the UI thread so animations never hitch or skip.
Fixes
- Eliminated Settings › Read Aloud modal flicker and layout jumps when
switching between voice models, and reused idle OS speech handles so
toggling to and from system voices stays responsive. - Hovering a word card into AI explanations now tracks scroll cleanly without
leaving stale loading captions or duplicate in-flight requests. - Kept the read-aloud player strictly along the bottom edge, tucking cleanly
below popups rather than jumping upward. - Opening any menu or popover automatically closes the floating Find bar, and
opening Find dismisses open popovers. - Kept custom window control icons on Windows and Linux steady on hover, and
aligned the API key input and Add button spacing in Settings › AI.
Which file to download
| System | File | Install |
|---|---|---|
| macOS 11 or later, Apple Silicon | Mareader_0.0.7_aarch64.dmg |
open it and drag Mareader to Applications |
| macOS 11 or later, Intel | Mareader_0.0.7_x64.dmg |
the same |
| Windows 10 or 11 (x64) | mareader_0.0.7_x64-setup.exe |
run it; it installs for you alone, no administrator needed |
| Windows 10 or 11 (x64, managed machines) | mareader_0.0.7_x64_en-US.msi |
msiexec /i it, or deploy it as usual |
| Windows 11 on ARM (ARM64) | mareader_0.0.7_arm64-setup.exe |
run it; installs native ARM64 Mareader for you alone |
| Debian, Ubuntu, Mint, Pop!_OS (x86_64) | mareader_0.0.7_amd64.deb |
sudo apt install ./mareader_0.0.7_amd64.deb |
| Debian, Ubuntu, Raspberry Pi OS (ARM64) | mareader_0.0.7_arm64.deb |
sudo apt install ./mareader_0.0.7_arm64.deb |
| Arch and its family (x86_64 & ARM64) | mareader_0.0.7_x86_64.tar.gz or mareader_0.0.7_aarch64.tar.gz with PKGBUILD |
put your archive and PKGBUILD in one folder, then makepkg -si |
| Any other Linux, x86_64 (glibc 2.35+) | mareader_0.0.7_x86_64.AppImage |
chmod +x it, then run it |
| Any other Linux, ARM64 (glibc 2.35+) | mareader_0.0.7_aarch64.AppImage |
chmod +x it, then run it |
Installing over v0.0.6 keeps your existing settings, session, library, and
highlights automatically. SHA256SUMS lists every file's checksum:
sha256sum -c SHA256SUMS --ignore-missing on Linux,
shasum -a 256 -c SHA256SUMS --ignore-missing on macOS.
The first launch
This build is not signed by Apple or Microsoft yet, so each system asks once:
- macOS: "Apple could not verify Mareader". Choose Done, then open System
Settings › Privacy & Security and choose Open Anyway next to Mareader. Later
launches open directly. - Windows: "Windows protected your PC". Choose More info, then Run anyway.
- Linux: nothing to approve. The AppImage only needs to be executable.
Known limits
- Neural voices are downloads of 24 MB to 327 MB each. System voices need
none. On Linux, system voices go through Speech Dispatcher. - Only Kokoro, Piper, and Kitten report exact word timing. With Phonon and
system voices the lit word follows the reading pace, so it can run slightly
ahead or behind. - Skipping tables, lists, figures, and asides works in EPUB, Markdown, and
plain-text books, not PDFs. - Windows on ARM64 currently ships as the NSIS installer (
-setup.exe);
.msipackages remain x64-only. - Your library stays on this computer; syncing between machines remains future
work.
Before publishing, CI built every installer on its own native platform (all
six runners), installed each one, verified its binary architecture, opened a
book with it, and removed it again.