Changelog

What's new

Recent releases have turned NarrateX from a reader of text into a reader of books: one structured document model, chapters found even where a book never marked them, a shelf of the books you already own and mathematics shown and spoken. Alongside that came a window drawn in pictures with a Guide behind its Help button, an update check, every voice on your machine before you start reading and a saved place that follows the book rather than its filename. The newest release also makes every download smaller.

v5.4.0

Mathematics shown and spoken; smaller downloads

  • A formula in a PDF or an EPUB comes back as a formula rather than as scattered letters, keeping its subscripts, superscripts, limits and fractions
  • The reading pane sets each script small and raised or lowered, so a chemical formula shows as O₂. The narrator says a formula in words: "the sum from k equals 0 to m of d sub k times 3 to the k"
  • An EPUB's formulas are read as a reader of the book would see them, never from the typesetting source stored beside them. A book with no mathematics reads exactly as before, so your bookmarks and saved place are untouched
  • Every build leaves out what NarrateX never uses: packages nothing imports, source and header files no program runs and the parts of Qt it never loads. The Windows setup program falls from 480 MB to 287 MB and unpacks on every core your computer has
  • Help > About now links the source code of the exact Qt and PySide6 versions your copy runs on, since both are licensed under the LGPL
v5.3.0

Your place follows the book, not its filename

  • A book is now recognised by its whole text rather than by its filename and first few pages. Renaming or moving a file keeps your place; two different books never share bookmarks
  • Existing bookmarks move across by themselves the first time you open each book after updating. A book whose text has been edited now starts afresh rather than reopening somewhere you did not stop
  • A damaged bookmark or settings file is set aside under a name ending in .damaged instead of being saved over, so what it still held stays on your disk. The status line names the file when it happens
  • Plain-text and Markdown books saved in an older Windows encoding keep their accented letters and curly quotes. A copy-protected EPUB is refused with a plain reason; a file holding nothing but separator lines is refused as having no text
  • On the shelf, a metadata.opf file is trusted only beside a single book, so a folder of many books no longer collapses into one tile. A genre you set survives a rescan
  • Installing from source on Linux now includes the language model the voice engine needs, so the first narration does not have to download it
v5.2.0

Every voice on your machine; reading fully offline

  • The first-run download fetched only 13 of the 28 voices the picker offers, so choosing another fetched it mid-reading and failed without a connection. The download now takes its list from the picker itself, so every voice is on your machine before the window opens
  • Once the voice model is downloaded, reading makes no network call at all. The daily update check is the one request that remains
  • The setup program accepted its --keep-user-data option then ignored it. The option now reaches the uninstall; the confirmation says plainly whether your bookmarks and shelf will be deleted or kept
  • A failing Stop now says "Playback failed (see log)" in the status line, as Play and Pause already did
  • The features have a page of their own on this site; every footer links to the rest of my work. The site also states more exactly what NarrateX does
  • A new document, DECISIONS-TRADEOFFS.md, sets out the choices NarrateX rests on and what each one costs
v5.1.1

A new donation page

  • The Donate button now opens a new PayPal page that suggests £5 and lets you give any amount you choose. Nothing else has changed
v5.1.0

A bookshelf; chapters for books that never marked them

  • A new button beside Select book shows the books you already own as a grid of covers or as a list with title, author, genres and how far through each one you are. It reads the folder you choose and every folder beneath it
  • Filter by genre from a catalogue of nineteen, search by title or author and order by author, by title or by most recently read. Right click a book to file it under a genre yourself; what you say outranks what the file says
  • Nothing is looked up online and nothing on disk is changed. A few thousand books scan in seconds; a rescan re-reads only what changed
  • Kindle books with no heading markup now gain chapters, first from the book's own navigation table, then from lines such as "Chapter 12" or "Prologue". A book that already worked cannot change
  • A converted Kindle book that showed no structure at all now reads as ordinary prose; its title, repeated as a header on every page, is no longer read aloud each time
  • Words in capitals are read as words rather than spelled out letter by letter. Only what an author marked with stops, such as "U.K.", is spelled
  • Kindle books open from the installed application instead of failing with a Calibre error. A book that is only pictures of its pages now says it has no text to read
v5.0.1

Tooltips while another program has focus

  • Hovering over NarrateX while you worked in another program showed no tooltip. The main window, every dialog and the setup program now show their tooltips whether they have focus or not
v5.0.0

A window drawn in pictures, with a Guide behind Help

  • Every emoji and worded button is replaced by artwork that looks the same on Windows, macOS and Linux; hovering any picture button names what it does
  • Every picture button shares one rounded ring: green on hover or keyboard focus, red while unavailable. Previous and Next chapter wear red whenever pressing them would do nothing
  • The speaker button mutes; press it again and the level you had comes back
  • A strip along the foot of the window holds a donate button and the two licence buttons. Nothing is held back behind a donation
  • The help button opens a menu: a Guide naming every control by the picture it wears, then About. The Guide and the licence texts read themselves slowly; any touch pauses them
  • Text areas no longer wear a green ring and dialogs open on their Close button
  • Repair and Uninstall move the progress bar as they work. A Repair that finds a file in use waits for it, then names the file and the program holding it
  • A commercial licence for NarrateX's own code is now available. The macOS build notarizes the application as well as its disk image
v4.2.0

NarrateX tells you when a newer release exists

  • Shortly after launch and once a day, NarrateX asks GitHub's public releases API whether a newer version has been published. Only a formally published release can prompt; the request carries nothing about you or your books and a failed check is silent
  • A newer release offers the download for your platform, Skip This Version and Later. A skipped release never prompts again
  • The About dialog gains a Check for updates button that reports every outcome
v4.1.0

Stop that stops; Play that starts at once

  • Stopping playback now actually stops the speech engine instead of leaving a background worker holding on to it
  • Pressing Play on a freshly loaded book is fast: the step that prepares the first chunks in advance had never run and now does
  • Startup and the setup program now record what they fall back to and why whenever something fails quietly
  • This site became three pages (an overview, Why this exists and Download) with a navigation bar; old deep links redirect to their new homes
  • Behind the scenes: the version lives in a single VERSION file, every icon is generated from one master, the test coverage requirement reaches the whole domain and application layers and the documentation was brought back in line with the code
v4.0.0

One structured document model

  • EPUB, PDF, Markdown and plain text are all read into one structured document model, the single authority for what is shown, what is spoken and where the book begins
  • Page numbers, running heads, contents entries and the index are shown where they belong and never read aloud. If the model covers less than 90% of a book's prose, NarrateX reads the whole book as flat text rather than drop anything
  • Remove current book forgets what NarrateX remembers about the loaded book, never the file itself. The reading pane shows headings, spacing and indentation; you can step backwards and forwards by chapter
  • Opening a book no longer freezes the window: the work runs in a separate process while a loading indicator runs throughout
  • One green ring marks hover and keyboard focus everywhere; a disabled control wears red. Enter activates the focused control and the cursor keys step round the ring like Tab
  • The voice picker offers 28 English voices (8 British, 20 American) behind sex and region toggles; no voice is chosen for you
  • The installer shows real progress, exits cleanly on cancel and asks before uninstalling
  • The download page shows live release details with links that always serve the newest build
v3.2.0

NarrateX on every desktop

  • NarrateX now runs on macOS as a disk image and on Linux as a Flatpak as well as on Windows, with the same features on each
  • The Linux edition is self-contained and is expected to work across most modern distributions
v3.0.0

Sharper icons

  • Every icon size is fixed; the main icon is no longer blurry on the Windows taskbar or desktop
v2.9.7

Icon refinements

  • The icon is reformatted and slightly larger on the Windows taskbar
v2.9.6

Icon fixes

  • The application's icons are fixed
v2.6.2

Installer title fix

  • The installer's title text is no longer cut off
v2.6.0

Start playback where you click

  • Click in the text to choose where playback starts
v2.5.1

Section breaks no longer restart the book

  • A line of three hyphens in the middle of a chapter no longer sends playback back to the beginning of the book
v2.5.0

EPUB and PDF reading reworked

  • EPUB and PDF books are read correctly: section headers are accurate and invalid sections are removed
  • A compilation of several books shows a top-level structure you can navigate
  • Navigation appears at once while processing carries on in the background; playback starts faster
v2.4.0

Volume remembered; PDFs start in the right place

  • Volume starts at 25% on a first install and is remembered between sessions
  • PDF playback starts at the correct place instead of a contents entry; section bookmarks are detected correctly
v2.3.0

Sections played in order

  • Sections are no longer skipped: introductions and intermediate sections play
  • The index and front matter, such as the contents, are skipped on purpose
v2.2.1

Playback starts at the first section

  • Playback starts from the first section bookmark, even where a book's contents are complex or inconsistent
  • Saving your place on close and restoring it on relaunch works again
v2.1.0

A splash screen and a single instance

  • A splash screen shows while NarrateX starts
  • Only one copy runs at a time; choosing it from the taskbar brings it to the front
v2.0.0

Automatic bookmarks and highlighting in step with the voice

  • Section and chapter bookmarks are generated automatically; your own bookmarks are clearly marked as yours
  • Text highlighting follows the audio
  • Clearer progress in the side navigation, more prominent play and pause controls and clearly marked disabled states
  • The core was rebuilt to clear accumulated technical debt, with a larger test suite holding its structure in place
v1.2.0

Speed, bookmarks and a chapter tree

  • Playback speed control, bookmarks and chapter navigation
  • Volume adjusts as you move it and is remembered
  • A chapter tree down the side of the window
v1.1.0

The first release

  • Narration in several British and American English voices, with play, pause and stop
  • The book's cover where it has one, text highlighted as it is read, bookmarks and chapter navigation
  • A Windows installer that installs, upgrades, repairs and uninstalls
  • Light and dark themes; Help, About and the licence from within the application