Skip to content

Releases

Mareader 0.0.7

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:56

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 compact EN ⇄ 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);
    .msi packages 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.

Mareader 0.0.6

Choose a tag to compare

@github-actions github-actions released this 17 Nov 08:27

Mareader 0.0.6

Mareader now ships native ARM64 builds for Windows and Linux, checks for
updates in-app with silent background updates on Windows and Linux AppImage,
opens large EPUBs progressively with instant reflow, and brings a redesigned
Appearance popover, animated icons, and a command palette.

Summary

New

  • Native installers for Windows on ARM and ARM64 Linux (Debian/Ubuntu, AppImage, and Arch).
  • Built-in update checks with silent background updates on Windows and Linux AppImage.
  • Progressive EPUB opening and instant reflow when resizing panes or changing typography.
  • Redesigned Appearance dial popover, animated icons, command palette, and eight offline dictionary packs.
  • Expanded EPUB layout, float, and book-wide picture theming across reflow and fixed-layout pages.

Fixes

  • Kept progressive EPUB pages steady and text edits fast without highlight or frame flicker.
  • Restored dark ink contrast in Dim mode and matched toast and icon colours to your theme.
  • Highlighted both spread thumbnails, aligned macOS traffic lights, and removed sidebar sidelines.
  • Reduced memory usage across EPUB covers, PDF tiles, document search, and offline neural voices.

What's new

  • Windows on ARM and ARM64 Linux. Native aarch64 builds now join x86_64
    and Apple Silicon: an ARM64 Windows setup installer plus ARM64 .deb,
    AppImage, and Arch Linux packages, each built and launch-tested on native
    ARM64 hardware in CI.
  • Built-in updates. Mareader checks GitHub Releases against verified
    SHA-256 checksums, surfaces concise release highlights in a startup update
    modal, and adds Settings › Updates controls. Writable Windows NSIS installs
    and Linux AppImages can download and apply updates silently in the
    background; macOS and package-managed installs open the matching download
    link directly.
  • Progressive EPUB opening and instant reflow. Large EPUBs open right away
    around your saved reading place while remaining chapters paginate in the
    background, and local typography or pane-width edits retypeset immediately.
  • Appearance dial popover and animated icons. Appearance controls now live
    in a tactile Dial deck popover with vertical-drag knobs, subtle animated
    semantic icons (toggleable in Settings), voice engine marks, and optional
    edge tabs for peeking floats.
  • Command palette and headless automation. Press ⌘K / Ctrl+K to search
    and run reader commands from the keyboard. Underneath, Mareader's reader
    engine now powers atomic settings.json / session.json persistence, a
    zero-UI CLI, and a live control channel.
  • Richer EPUB layout and picture theming. Improved CSS colour, z-order,
    multi-column, spanning-float, and cover handling, plus consistent
    theme_pictures styling across reflow pages, fixed-layout spreads, and
    thumbnails.
  • Eight offline dictionary packs. Settings › Dictionary now offers eight
    downloadable Wiktionary packs with folded views for packs you haven't
    installed yet, Japanese headword pronunciation in a Japanese voice, and
    smarter parking between the dictionary card and read-aloud player.
  • Lower memory use. Streamed EPUB cover loading, cached PDF render
    sessions across tiles, streamed Kokoro weights, zero-allocation search
    scanning, and reused GPU buffers reduce peak memory across reading and
    narration.

Fixes

  • Progressive EPUB growth keeps the current reading position steady and avoids
    highlight or frame flicker while resting text caches cleanly.
  • Dim mode restores dark book ink so dimmed pages stay calm and readable.
  • Toast notifications harmonise their semantic colours with the active theme,
    stack cleanly, and step aside for the dictionary window and menus.
  • Hovering or rapidly clicking toolbar icons preserves their active tint and
    completes animations smoothly.
  • Spread view highlights both visible pages in the Thumbnails sidebar.
  • Fold and selection sidelines are removed for a cleaner reading surface, and
    centralized layer ordering keeps popovers, modals, and toasts cleanly
    stacked.
  • On macOS, traffic-light window buttons stay aligned during animated resizes
    with breathing room beside the sidebar icons.
  • Erasing reading progress now resets currently open books immediately.

Which file to download

System File Install
macOS 11 or later, Apple Silicon Mareader_0.0.6_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.6_x64.dmg the same
Windows 10 or 11 (x64) mareader_0.0.6_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows 10 or 11 (x64, managed machines) mareader_0.0.6_x64_en-US.msi msiexec /i it, or deploy it as usual
Windows 11 on ARM (ARM64) mareader_0.0.6_arm64-setup.exe run it; installs native ARM64 Mareader for you alone
Debian, Ubuntu, Mint, Pop!_OS (x86_64) mareader_0.0.6_amd64.deb sudo apt install ./mareader_0.0.6_amd64.deb
Debian, Ubuntu, Raspberry Pi OS (ARM64) mareader_0.0.6_arm64.deb sudo apt install ./mareader_0.0.6_arm64.deb
Arch and its family (x86_64 & ARM64) mareader_0.0.6_x86_64.tar.gz or mareader_0.0.6_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.6_x86_64.AppImage chmod +x it, then run it
Any other Linux, ARM64 (glibc 2.35+) mareader_0.0.6_aarch64.AppImage chmod +x it, then run it

Installing over v0.0.5 imports your existing settings, session, library, and
highlights automatically on first launch. 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);
    .msi packages 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.

Mareader 0.0.5

Choose a tag to compare

@github-actions github-actions released this 29 Oct 04:23

Reading aloud becomes reading along: the words light up as they're
heard, a new player sits over the page, and a fourth voice model joins
the others. Mareader also gets a new icon. This release gathers
everything since v0.0.4.

What's new

  • Read along. The words light up as they're spoken, timed to the
    voice itself with Kokoro, Piper and Kitten. Light one word, a few, or
    a whole phrase; phrases break where the voice pauses.
  • A new player. A compact player sits over the page. Drag its sides
    to make it wider or narrower. When the words being read scroll out of
    view, it grows into a card showing them; Settings › Read aloud chooses
    Full, Compact or the bar alone. It takes on the look of its book's
    pane, and its time left counts down evenly. When something goes wrong,
    it says what happened and how to fix it.
  • Start where you choose. Right-click a word to read from it; the
    word lights up and the menu sits beside it, not over it. Select text
    to read only that. Right-click empty space to read from the start of
    that passage. A marker shows where reading will begin.
  • Reading carries on. Speech is prepared about 20 seconds ahead, so
    sentences follow each other without a gap. Reading goes on after the
    book leaves its pane, and a book opened again picks up where it was
    being read.
  • Skip what reads badly aloud. Tables, lists, figures and asides can
    each be read, skipped, or asked about every time, in EPUB, Markdown and
    text books.
  • Phonon, a fourth voice model. English voices that read text as
    written, numbers, money and addresses included. It's a 64.5 MB
    download with 26 American and British voices of 256 KB each, and it
    reads at every speed from 0.5 to 3.
  • Kokoro Tiny. A fourth Kokoro build of 92 MB, smaller than Small's
    141 MB, a little rougher in sound.
  • Voices start and speak sooner. Models load in about half the time,
    and Kitten and Kokoro start speaking well over a second sooner.
  • A new dictionary. The dictionary window and page are redesigned.
    The headword is spoken with your voice, or with another voice from the
    same model when yours doesn't speak that language. English IPA
    follows your voice's accent, American or British. Word cards show the
    word class and level after the headword.
  • Zoom that follows the pane. Fitted zooms refit as the pane
    resizes. Turn on "Scale my zoom with the pane" in Settings › Layout,
    and a zoom you set shrinks with a narrower pane, then grows back, never
    past what you set.
  • A calmer library. Covers look bound, reading progress shows as a
    bookmark ribbon, and organizing with AI gives quieter feedback.
  • A new icon: an ivory open book with gilt edges and a gold ribbon
    on onyx.

Fixes

  • Wrapped lines in PDFs join into paragraphs, so they read aloud
    smoothly and reflow cleanly, and lines beside a figure wrap at it.
  • A narrated book's highlight takes your accent colour, not the book's.
  • Notifications move aside for menus and bars that open under them.
  • Selected items stand out in light tinted themes.
  • On macOS, the window buttons line up with the sidebar's icons at any
    interface zoom, and stay visible in light themes.
  • Open… left the reader's menu; ⌘O or Ctrl+O still opens a book.

Which file to download

System File Install
macOS 11 or later, Apple silicon Mareader_0.0.5_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.5_x64.dmg the same
Windows 10 or 11 mareader_0.0.5_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows, managed machines mareader_0.0.5_x64_en-US.msi msiexec /i it, or deploy it as usual
Debian, Ubuntu, Mint, Pop!_OS mareader_0.0.5_amd64.deb sudo apt install ./mareader_0.0.5_amd64.deb
Arch and its family mareader_0.0.5_x86_64.tar.gz and PKGBUILD put both in one folder, then makepkg -si
Any other Linux (glibc 2.35 or newer) mareader_0.0.5_x86_64.AppImage chmod +x it, then run it

Installing over v0.0.4 keeps your library, settings and highlights. The
interface zoom goes back to 100% once. Piper now offers only voices
trained on public-domain recordings: Alba, Joe, Mike, Reza, Sam and
Kathleen are gone, and their files are deleted at start if you
downloaded them. Your system may keep showing the old icon until its
icon cache refreshes.
SHA256SUMS lists every file's checksum: sha256sum -c SHA256SUMS --ignore-missing on Linux, shasum -a 256 -c SHA256SUMS --ignore-missing
on a Mac.

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. The system voices
    need none. On Linux, the system voices go through Speech Dispatcher.
  • Only Kokoro, Piper and Kitten say when each word is heard. With Phonon
    and the system voices the lit word follows the reading pace, so it can
    run a little ahead or behind.
  • Skipping tables, lists, figures and asides works in EPUB, Markdown and
    text books, not PDFs.
  • Your library stays on this computer; syncing between machines comes in
    a later release.
  • Linux packages are for x86_64 only; ARM Linux and Windows on ARM have
    no build yet.

Before publishing, CI built every installer on its own system, then
installed each one, opened a book with it and removed it again.

Mareader 0.0.4

Choose a tag to compare

@github-actions github-actions released this 25 Oct 10:32

Read aloud arrives: any book in the system's voices or in neural voices
that download in Settings, plus pronunciation on word cards, live reload
and a lighter app. This release also gathers everything since v0.0.3.

What's new

  • Read aloud. Any book reads aloud from where you right-click or
    press the shortcut. Each sentence lights up as it's read, and pages turn
    by themselves. The system's own voices work with no download. Pick the
    voice, speed, pitch and volume in Settings › Read aloud, and hear a
    sample before you choose.

  • Neural voices. Three voice models download in Settings and run on
    your computer, with nothing sent anywhere:

    • Kokoro: natural voices in English, Spanish, Italian, Portuguese,
      French, Hindi and Mandarin. It comes in Full, Half and Small builds,
      so you can trade size for quality.
    • Piper: quick on any computer, with eleven English voices.
    • Kitten: the lightest, from 24 MB, with eight English voices.

    Voices share their pronunciation data on disk. A model that hasn't
    been used for a while unloads, and its memory goes back to the system.

  • How words sound. Dictionary and AI cards show an English word's
    pronunciation, American, British or both, as IPA or an easy respelling.
    A speaker button says the word aloud. The pronunciation data is a
    download in Settings › Vocabulary and shares files with the voice
    models.

  • Books reload when saved elsewhere. Edit a note, re-export a PDF or
    rebuild an EPUB in another app, and the open book reloads by itself
    within about two seconds, staying where you were reading.

  • A book's own design. EPUB chapters keep their boxes, margins and
    rules. Pages fill the pane in Single and Two pages views. Settings are
    grouped into folds.

  • AI settings in two tabs. AI holds what the AI does: the AI
    Dictionary, the library organizer and page tasks. AI models holds the
    models, with each provider's logo and what each model is used for.

  • One kind of dialog. Every sheet and alert is a centred card over
    the same backdrop.

  • Notifications stack in the corner. They pile up bottom-right. Click
    to open the pile, swipe one away or clear them all. Repeats are counted
    instead of piling up.

  • Search as a capsule over the page, with a map of its hits.

  • Lighter. Closed books let go of their memory, paragraphs take
    about 40% less room, a long book closes about 30 MiB lower, and the
    download is smaller.

Fixes

  • Windows shows Mareader's icon in Explorer, the Start menu, desktop
    shortcuts, pinned taskbar buttons and Installed apps, instead of the
    generic program icon. The setup program shows it too.
  • Imported Markdown notes keep their pictures, including ones from
    folders above the note and ones written as HTML <img> tags, even
    after the original is gone. Removing the book removes them.
  • Files you pick or drop are always copied into the library, and books
    copied in before are no longer treated as read in place.
  • Highlights, selections and search matches in reflowed books are as tall
    as the letters, not the whole line.
  • With the sidebar floating, the title bar's buttons no longer open it by
    accident.
  • Changing the type keeps your reading place.

Which file to download

System File Install
macOS 11 or later, Apple silicon Mareader_0.0.4_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.4_x64.dmg the same
Windows 10 or 11 mareader_0.0.4_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows, managed machines mareader_0.0.4_x64_en-US.msi msiexec /i it, or deploy it as usual
Debian, Ubuntu, Mint, Pop!_OS mareader_0.0.4_amd64.deb sudo apt install ./mareader_0.0.4_amd64.deb
Arch and its family mareader_0.0.4_x86_64.tar.gz and PKGBUILD put both in one folder, then makepkg -si
Any other Linux (glibc 2.35 or newer) mareader_0.0.4_x86_64.AppImage chmod +x it, then run it

Installing over v0.0.3 keeps your library, settings and highlights. On
Windows, a shortcut made by v0.0.3 may keep the generic icon until it is
made again, or until Windows refreshes its icon cache.
SHA256SUMS lists every file's checksum: sha256sum -c SHA256SUMS --ignore-missing on Linux, shasum -a 256 -c SHA256SUMS --ignore-missing
on a Mac.

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. The system voices
    need none. On Linux, the system voices go through Speech Dispatcher.
  • Live reload follows files read in place. Books copied into the library
    don't change.
  • Your library stays on this computer; syncing between machines comes in
    a later release.
  • Linux packages are for x86_64 only; ARM Linux and Windows on ARM have
    no build yet.

Before publishing, CI built every installer on its own system, then
installed each one, opened a book with it and removed it again.

Mareader 0.0.3

Choose a tag to compare

@github-actions github-actions released this 20 Oct 02:20

Page AI arrives: summarize, translate or simplify any page, kept with
the book. This release also gathers everything since v0.0.2.

What's new

  • Page AI. Right-click a page to summarize it, translate it or
    simplify it. A PDF's result covers its page on the same paper and is
    set smaller to fit. Numbered bubbles switch between results and the
    original page. Code, pictures and tables are never sent and keep
    their places.
  • A book's results become pages. In an EPUB, Markdown or text book,
    a result is laid into the book in your own type. A long one runs on
    over more pages, font changes set it again, and turning it off gives
    the book its own pages back. Your place, bookmarks and highlights
    hold.
  • Type for a PDF's results. Once a PDF has an AI page, Settings ›
    Appearance shows the font, size and spacing its results use.
  • Continuous mode. Translate or simplify as you read: after a short
    stay on a finished page, the next few pages are asked ahead. Moving
    far away pauses and asks before carrying on.
  • Results kept with the book. Results are saved and come back next
    time. Redo, copy or delete one from its bubble.
  • Organize with AI. Let a model sort loose books onto shelves. A run
    can be paused, resumed after an error, or discarded.
  • Library from the sidebar. Move, rename and nest shelves, make new
    ones and import books, all from the sidebar's tree.
  • Named models. Give each model a name and pick which one each task
    uses. Busy models say so instead of failing quietly.
  • Lighter. Rendered pages are handed over without a copy, and
    machine fallback fonts are mapped once, so long books use less memory.

Fixes

  • Erasing a book's data now removes its AI pages and Explain answers
    from the disk as well.
  • Page AI results never scroll inside themselves; the wheel always
    scrolls the book.
  • A lifted pane's space closes up when it's moved.

Which file to download

System File Install
macOS 11 or later, Apple silicon Mareader_0.0.3_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.3_x64.dmg the same
Windows 10 or 11 mareader_0.0.3_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows, managed machines mareader_0.0.3_x64_en-US.msi msiexec /i it, or deploy it as usual
Debian, Ubuntu, Mint, Pop!_OS mareader_0.0.3_amd64.deb sudo apt install ./mareader_0.0.3_amd64.deb
Arch and its family mareader_0.0.3_x86_64.tar.gz and PKGBUILD put both in one folder, then makepkg -si
Any other Linux (glibc 2.35 or newer) mareader_0.0.3_x86_64.AppImage chmod +x it, then run it

Installing over v0.0.2 keeps your library, settings and highlights.
SHA256SUMS lists every file's checksum: sha256sum -c SHA256SUMS --ignore-missing on Linux, shasum -a 256 -c SHA256SUMS --ignore-missing
on a Mac.

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

  • Page AI needs a model: set one up in Settings › AI. Apple Intelligence
    needs a Mac with Apple silicon and macOS 26, and doesn't speak every
    language.
  • A PDF's results are text only.
  • Your library stays on this computer; syncing between machines comes in
    a later release.
  • Linux packages are for x86_64 only; ARM Linux and Windows on ARM have
    no build yet.

Before publishing, CI built every installer on its own system, then
installed each one, opened a book with it and removed it again.

Mareader 0.0.2

Choose a tag to compare

@github-actions github-actions released this 18 Oct 17:00

Mareader has its own icon: an open book whose edges draw an M, with one
line highlighted. This release also gathers everything since v0.0.1.

What's new

  • Dictionary page. A Dictionary button in the Library and reader title
    bars, or Cmd/Ctrl+Shift+D, opens a full dictionary: every pack or one,
    Languages mode from one language to another (bridged through English
    when no pack joins them), close matches, recent searches and the
    keyboard throughout.
  • Floating dictionary. In the reader it floats over the page instead:
    move it, resize it, fold it to a small pill that shows the word and its
    answer, or open it as a page. While it's open, Look up answers in it and
    the selection stays. Settings › Dictionary › In the reader can choose
    the full page instead.
  • Notes and bookmarks. Write a note on any highlight; a Notes panel
    lists them by chapter, with search. Bookmark pages. Export highlights
    and notes, and restyle one highlight or several at once.
  • A rebuilt Library. A home-screen grid you arrange by dragging, with
    shelves you make by stacking books, multi-select, a list view, watched
    folders with a single import form, links and duplicates, and a compact
    way to remove books.
  • Reading. Grab empty space to pan the pages; hold a pane to lift and
    move it; open pictures large with a double click; footnotes open in
    place; reopen recent books from an empty pane.
  • Look and feel. A compact, foldable Appearance popover; a keyboard
    shortcut sheet; a redesigned lookup card that points at its word;
    Burmese and other complex scripts shaped in every panel; small text
    kept readable on every paper.
  • AI. Models refresh and fetch on their own; one download fetches the
    word-level data, with options after.

Which file to download

System File Install
macOS 11 or later, Apple silicon Mareader_0.0.2_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.2_x64.dmg the same
Windows 10 or 11 mareader_0.0.2_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows, managed machines mareader_0.0.2_x64_en-US.msi msiexec /i it, or deploy it as usual
Debian, Ubuntu, Mint, Pop!_OS mareader_0.0.2_amd64.deb sudo apt install ./mareader_0.0.2_amd64.deb
Arch and its family mareader_0.0.2_x86_64.tar.gz and PKGBUILD put both in one folder, then makepkg -si
Any other Linux (glibc 2.35 or newer) mareader_0.0.2_x86_64.AppImage chmod +x it, then run it

Installing over v0.0.1 keeps your library, settings and highlights.
SHA256SUMS lists every file's checksum: sha256sum -c SHA256SUMS --ignore-missing on Linux, shasum -a 256 -c SHA256SUMS --ignore-missing
on a Mac.

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.

macOS and Windows may keep showing the old icon for a while, as they
cache icons; it updates after a restart or once the cache refreshes.

Known limits

  • Apple Intelligence needs a Mac with Apple silicon and macOS 26.
  • Your library stays on this computer; syncing between machines comes in
    a later release.
  • Linux packages are for x86_64 only; ARM Linux and Windows on ARM have
    no build yet.

Before publishing, CI built every installer on its own system, then
installed each one, opened a book with it and removed it again.

Mareader 0.0.1

Choose a tag to compare

@github-actions github-actions released this 16 Oct 20:16

The first build of Mareader for macOS, Windows and Linux: a calm reader
for PDF, EPUB, plain text and Markdown, native (egui and wgpu, no webview).

Inside: single, spread, vertical and horizontal page views; every
typography setting for books; up to four panes, each with its own theme;
light, dark and dim papers with tints, textures and grain; a library with
shelves and watched folders; highlights, gloss cards, offline dictionaries,
CEFR word levels and Explain through Apple Intelligence or the AI provider
you choose; search in both formats; and full keyboard control.

Which file to download

System File Install
macOS 11 or later, Apple silicon Mareader_0.0.1_aarch64.dmg open it and drag Mareader to Applications
macOS 11 or later, Intel Mareader_0.0.1_x64.dmg the same
Windows 10 or 11 mareader_0.0.1_x64-setup.exe run it; it installs for you alone, no administrator needed
Windows, managed machines mareader_0.0.1_x64_en-US.msi msiexec /i it, or deploy it as usual
Debian, Ubuntu, Mint, Pop!_OS mareader_0.0.1_amd64.deb sudo apt install ./mareader_0.0.1_amd64.deb
Arch and its family mareader_0.0.1_x86_64.tar.gz and PKGBUILD put both in one folder, then makepkg -si
Any other Linux (glibc 2.35 or newer) mareader_0.0.1_x86_64.AppImage chmod +x it, then run it

Each installer opens PDF, EPUB, text (.txt, .text) and Markdown
(.md, .markdown, .mdown) files from your file manager. SHA256SUMS
lists every file's checksum: sha256sum -c SHA256SUMS --ignore-missing
on Linux, shasum -a 256 -c SHA256SUMS --ignore-missing on a Mac.

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

  • On Windows, the setup makes Mareader open PDF, EPUB, text and Markdown
    files unless you already chose another app for them; .txt files
    then open in Mareader rather than Notepad. Uninstalling restores them.
  • Apple Intelligence needs a Mac with Apple silicon and macOS 26.
  • Your library stays on this computer; syncing between machines comes in
    a later release.
  • Linux packages are for x86_64 only; ARM Linux and Windows on ARM have
    no build yet.

Before publishing, CI built every installer on its own system, then
installed each one, opened a book with it and removed it again. The Arch
package is the exception: CI checks its contents and PKGBUILD, as no
Arch runner exists.