1.0.1

Housekeeping, mostly. Submitting to the community plugin list runs your code through an automated review, and the important issues have been addressed in this release.

Fixes:

• Clicking a highlight that has no note attached now opens the note box. The little "add a note" link that appeared on hover was, on desktop, almost impossible to actually click. Now the highlight itself is the button.

• Text should break more sensibly at the end of a line: hyphenated words, dashes, quotes, currency and anything that isn't English prose. This comes from an update to Pretext, the text layout engine, which also closes a hole where an odd enough book could break the reader.

Importing books:

• The importer takes a folder now, instead of asking you to pick each book by hand. Point it at your Apple Books folder and it finds every book inside, then you tick the ones you want.

• It does this without touching your filesystem at all any more. The plugin can no longer read anything outside your vault, though it might feel slightly unintuitive. Small price for better security, I say.

Under the hood:

• Removed two decade-old compatibility shims that came in with the zip library. They never ran, but they looked enough like something dodgy to fail the automated review, and they're no loss.

• The HTML sanitiser (the thing that makes sure a book can't run code at you) is on its latest version.

Install: Settings → Community plugins → Browse → Third Mind Reader.

1.0.0

At long last. 1.0. A lot of the work was to polish everything up, so an extra special thank you to everyone who tested the beta and gave me feedback.

Your library, and where you keep it:

• The Library folder is a setting now. Point it at the folder of EPUBs & PDFs you already have and the shelf picks them up as you'd expect. No moving anything, no Library/ folder appearing in your vault unless you choose to have it. Subfolders still work as collections.

• First run asks where your books live before it creates anything. Only once, on a fresh install.

• If you move it later and you've already annotated something, you're asked whether to bring those notes along.

Reading and annotating:

• With AI off, selecting text takes you straight to the note box. On by default on desktop, off on mobile; there's a setting either way.

• Tapping a highlight that has no note attached now offers to add one, in the reader, rather than telling you to go and find it in the panel.

• "How to use the reader" is in the command palette, and there's a How to use button at the bottom of settings. A beta tester closed the cheat sheet and couldn't find their way back to it, which is fair enough.

• Tidied up the settings page (long overdue), and it now has three buttons: How to use, Feedback, and a tip jar, if you're so inclined.

Fixes:

• Tapping out of a selection no longer turns the page. It wouldn't when text was selected; the problem was that iOS clears the selection a moment sooner than the check.

• Long unbroken filenames (PDFs, mostly) ran straight out of their Library card and pushed the shelf around. They wrap now.

• The chat box in Conversations hid under the mobile keyboard, and the fade over the conversation sat halfway up the screen. Same miscounted measurement behind both.

• The reader doesn't work in pop-out windows and never has — every keyboard shortcut and the whole annotation toolbar live on the main window. Rather than let you find that out mid-sentence, a book in a pop-out now says so and offers to move itself back. PDFs get a note to the same effect. Proper support is on the list.

• A crash when closing a PDF tab, and a few things that only misbehaved in Obsidian's newest version.

Under the hood:

• Importing a folder of Apple Books epubs no longer shells out to a zip command, which means it works on Windows now. It also means the plugin runs no external commands at all any more.

Install: Settings → Community plugins → Browse → Third Mind Reader.

0.6.0-beta

Third Mind Reader 0.6.0-beta — the mobile update.

The big ones

Mobile support. The reader now runs on tablets and phones. Tablets get an experience near-identical to desktop; phones get a bespoke UI built for the smaller screen. All features carry over.

Bookmarks. Bookmark any page — it is written into the companion note like every other annotation, and the position survives a change of device, window size or font size.

PDF support. The GlossBar highlighting interaction now works inside Obsidian's own PDF viewer, and PDFs appear in the Library view alongside your EPUBs.

Also in this release

• Reader text reflows to fill the available space and matches your Obsidian body text size by default (override in Settings → Reading).
• [[wikilink]] autocomplete while writing a highlight — type [[ and you get the same file suggestions as anywhere else in Obsidian.
• Library view sorts your current reads to the top of the shelf.
• OpenRouter added as an AI provider.
• Deferred inference: queue AI annotations while reading on mobile; they resolve against your local model next time the book opens on desktop.
• Callout behaviour updated for Obsidian 1.13.

Install (BRAT)

Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

---

Requires Obsidian 1.13.0 or later. Desktop, iPad and iPhone; Android is untested but should work — reports welcome. AI features are optional and bring-your-own-provider, built for local models first; no telemetry. Feedback via the in-app Send feedback button.

0.5.9-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

Changelog

PDF Support! PDFs are annotatable now. The whole Glossbar interaction works on Obsidian's own PDF viewer. Alongside that: link autocomplete in the annotation box, companion notes finally showing up in the graph, and encrypted books saying so instead of opening as nonsense.

PDF annotation:

• Select text in any PDF and the Gloss toolbar appears, exactly as it does in the reader. All five modes work, AI included — Explain, Examine, Exclaim and Enquiry each open a conversation in the pane.

• The Highlights pane comes along too, reachable from the PDF's own toolbar or with h. Annotations group by page, conversations behave as they do in the reader, and clicking a highlight opens its chat.

• Nothing about Obsidian's PDF viewer is replaced or patched — the plugin only adds listeners and its own overlay on top. If a future Obsidian update changes the viewer's internals, PDF annotation switches itself off rather than taking the viewer down with it.

• Annotations are anchored with Obsidian's own PDF links (#page=17&selection=...), so every callout is a real link back into the document. It works in the graph, in search, and alongside PDF++.

Additions:

• [[ autocomplete in the annotation box — type [[ while writing a note and you get the same file suggestions the editor gives you, brackets auto-paired, Enter to pick.

• Encrypted epubs now fail with a plain explanation instead of opening as a book of garbage characters. To be explicit about the limitation: Third Mind Reader reads DRM-free epubs only, and that won't be changing — LCP decryption requires a certified licensee key that an open-source plugin has nowhere to keep. Font-obfuscated books (common in InDesign exports) are unaffected and still open normally.

Fixes:

• Companion notes now actually link to their book in the graph. The source: property was written in a form YAML didn't read as a link, so the connection was never drawn — for every book, since the feature shipped. Existing notes repair themselves on load.

• Clicking an epub link inside a note opens it in a reader tab instead of replacing the note you were reading.

• The progress bar tracks the reading column instead of stretching the full pane, and the page counters no longer vanish in books with a lot of chapters.

• Annotation notes no longer grow an extra blank line inside every callout each time the AI replies.

• Switching books with the Highlights pane open no longer swallows the next h.

Under the hood:

• The Gloss toolbar, the Highlights pane and the PDF controller now live in their own modules, taking main.ts from 6,519 lines to 4,452. Both readers drive the same pane through one interface, so a fix in either lands in both.

0.5.7-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

0.5.6-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

0.5.5-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

0.5.4-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

0.5.3-beta

Beta build of Third Mind Reader for testing via BRAT.

Install (BRAT): Add a beta plugin for testing → Hipst3rMusic/obsidian-third-mind-reader → enable in Community Plugins → open any .epub.

Desktop only. AI features are optional / bring-your-own provider; no telemetry. Feedback via the in-app Send feedback button.

0.5.2-beta

First public beta of Third Mind Reader, for testing via BRAT.

Install (BRAT): In BRAT, choose "Add a beta plugin for testing", enter Hipst3rMusic/obsidian-third-mind-reader, then enable Third Mind Reader in Community Plugins and open any .epub.

Desktop only. AI features are optional and bring-your-own provider (local or cloud) — no telemetry, no network calls unless you use an AI feature. Found a bug or have feedback? Use the Send feedback button at the top of the plugin's settings.