Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.16.0 - 2026-11-18
Security
- A page we did not write cannot reach a message handler. Which of the app's own pages each message may be posted from is now a table checked before any handler runs, rather than a guard every handler had to remember — one was forgotten once, and a site could turn the reader off for itself. Turning the reader back on from a site's own chrome still works, and is the only thing that may.
- A site cannot post as the reader while it is being replaced. For a moment after each article was opened, the site's page could send messages as the reader page, including clearing recents on every synced device. Every page the app writes now carries a token that only it holds, and a message without it is treated as the site's.
- An article cannot run script in the reader page. A site answering for the extraction could put script in its article and use the reader to clear recents everywhere, change settings or hide text. The article is now cleaned before it is shown, and the reader page allows only its own scripts and video players from the known video hosts.
- Nothing in an article can stand in for the reader's controls. An article's styles can no longer draw over the toolbar, popovers or Read next, where a decoy could take a click meant for a control such as Clear history. A label in an article can no longer press a reader control either.
Added
- A public site under
site/— landing page, privacy policy, support and changelog — for the App Store's two required URLs and the download the Homebrew cask fetches, now that the repository is private. Privacy and changelog are rendered from the repository's own files rather than copied. Scripts/play.shbuilds and signs the Android app bundle for Google Play, with the version code taken from the commit count.- Sync carries suggestion sources, the language filter and blocked outlets. A feed added or removed on one device is added or removed on the others. A device still on the shipped feeds takes the other devices' list instead of adding the defaults back.
- The suggestions heading shows when the feeds were last fetched, with a refresh button beside it that fetches them now.
- Copy an article's link from the reader. A link button in the reader's controls copies the original article's address, tracking parameters removed, and says "Link copied." It works on every platform, including the phones, which have no address bar to copy from.
Changed
- The button over a site's own page reads "Enable reader mode". It was "Read this page", and the Home button beside it, which did nothing, is gone.
- The Sync settings and the folder picker say that WebReader creates a “WebReader” folder inside the one you pick, so there is no need to make one yourself.
- Suggestions favour today's news. Read next, the popover and the start page weigh how recent an article is alongside how well it matches your reading, and leave out anything older than three days unless there is too little newer to fill the list.
- Android ships through Google Play only, so the GitHub release no longer builds APKs. The Android version name now follows the Mac app's instead of a copy that had fallen behind.
- One remove tool. The eye-off button is gone: Remove from this article carries its badge, and the list of hidden text opens from Hidden text in the remove bar. The bar stands out from the page in every theme, its buttons say what they do (Undo, Done removing, Hide this text in all articles), and it says what you just removed.
- In the reader, ⇧⌘C on the Mac and Ctrl+Shift+C on Linux copy the same cleaned article address as the reader's link button.
Fixed
- Suggestions leave out what is in your recents, whatever its address. An article you read under another link, or the same headline from another outlet, is no longer offered again in Read next, the recents popover or on the start page.
- "Show the original page" works on Linux. The button was drawn there but reached nothing, so a site the reader cannot read — a paywall, a login — had no way past it. The GTK host now keeps that host's own page, injects the way back on every load of it, and remembers the choice like the other hosts do.
brew install --cask webreaderworks again. It downloaded a release asset from the repository, which is private now, so every install got a 404. The download is served by webreader.yepz.dk instead, and the release script checks the URL is live and matches the checksum before the cask is pushed.- Suggestions no longer go blank for ten minutes after a sync. A fetch interrupted by the next one was remembered as "no articles"; it is now discarded. With sources that produced nothing, the list says so instead of asking you to add a source.
- Back works on a page the reader could not read. A link opened from the start page that turned out not to be an article left Back disabled; it now returns to where it was opened.
- Every control behind the burger is reachable in landscape. The open column was as tall as its contents, so on a phone on its side three buttons sat above the top of the screen. It now fits the window and scrolls, like the panels beside it.
- An embedded video player wider than the reading column now fits inside it, at its own shape, instead of running past the text.
- Video clips are no longer suggested — DR's reels opened as a full-screen player with nothing to read.
- The two start-page headings sit level again when recents and suggestions share a row.
Documentation
- The 588-line
CLAUDE.mdis five documents with one subject each, and the root file is a map to them.STORE.mdis replaced by a submission procedure that holds no listing copy and no deliberation — App Store Connect is the source of truth for those. docs/google-play.mdcovers the Play Console setup, the answers that are decisions, and the closed test a personal account needs before production.- Installing a debug build on a phone uses
adb install -d, which an older build needs, anddocs/google-play.mdsays that a sideloaded build must be uninstalled, with its local data, before Play's will install. - Release notes are written only in the release pull request, from the pull requests merged since the last tag, so feature branches no longer conflict on the changelog.
0.15.0 - 2026-09-21
Added
- First-run tips on the start page. Five things the app does that nothing on screen said it did — the share/open route, your own feeds, what is behind Aa, hiding text, and steering suggestions. Dismissed once with "Got it"; the same list stays on the settings page.
- Swipe a sheet away. On a phone the appearance, recents and hidden-text panels are sheets with a grab handle; dragging the handle down now dismisses them, as the handle always implied. A short drag settles back, and a drag through a list still scrolls it.
Changed
- Three free feeds ship instead of one. DR Indland and Udland in Danish, BBC News in English, replacing the wallnot.dk aggregator — more to read on the first launch, in two languages, and most rows now carry a thumbnail. Sources you have already chosen are untouched.
- More to read next. The ranked list is 20 deep instead of 8, so the start page offers a column rather than a handful; the end of an article now suggests five articles instead of three, and the recents panel eight instead of five.
- Remove things from an article by pointing at them. A new chrome button turns the article into something you aim at: the block under the pointer is outlined, a click takes it — text, pictures and the space it held — and the bar has Undo. What you remove stays gone in that article's saved copy; a reload fetches the publisher's version again.
- Selecting text in the reader is the browser's own business again. The floating "Hide text" button that followed your selection is gone: it fought the system's selection controls on every platform. Hiding a phrase in every article is now offered on the block you just removed.
Fixed
- The top of an article on a phone. The status bar goes while you are reading — as it does on Android — so the clock and the battery stop sitting over the text, and the reader's scroll hairline moved to the very top edge instead of drawing a rule across the first paragraph. Every other page brings the bar back.
- The controls behind the burger sit on a panel. Opened on a narrow screen they were seven separate pills in the page's own background colour, with article text showing through the gaps between them; they now share one surface, like the popovers do.
- An article read from a BBC feed is not suggested again. BBC stamps tracking parameters on every link in its feeds, which made the feed's copy of an article count as a different one.
Documentation
- How to put the current branch on a phone: the TestFlight path and its three rules (build
number, dirty trees, "Internal Only"), and the two
adbtraps that make an Android install look like it worked when it did not.
0.14.2 - 2026-09-14
Fixed
- The appearance sheet leaves a third of the article on screen. It took most of the page, and every control in it changes the text underneath — so the strip that stays is the only feedback they have. The dimming behind it lightened to match.
0.14.1 - 2026-09-14
Fixed
- The appearance controls work on a small phone. On a screen short enough that the panel ran out of room — an SE, or any phone on its side — every row collapsed to a 2px line, taking its buttons and labels with it.
- On a phone the appearance controls are a sheet, anchored to the bottom edge with a grab handle and a dimmed page behind. It scrolls itself now instead of handing the flick to the article, and a phone on its side lays the rows out in two columns.
- The theme and colour swatches are a finger wide. They were 34px, ten under the floor; the colour stays the size it was.
0.14.0 - 2026-09-11
Added
- Choose how loud a link is, not just what colour (#45). Four levels: follow the text and let the underline mark it, or a bright, tinted or hushed shade of your chosen hue. Hushed is the new default — the old saturated links read as noise on a page whose point is not having any. Every shade still clears 4.5:1 on every theme.
- The start page has its own appearance popover with its own text size and typeface, plus which of its two lists leads and whether rows carry thumbnails. Its lists were pinned smaller than anything you could choose; sharing the reader's settings was worse, since a 22px serif article dragged them along with it.
- The reader's popover gained the controls that belong to it: quotes, thumbnails and which edge its buttons sit against.
- Every row in both popovers says what it does. Controls a screen reader could name and a sighted reader had to guess at.
Changed
- The app has an icon of its own. A brass drop cap opening a paragraph, with a page
marker beside it, replacing the placeholder W on slate. Every platform renders from one
SVG through
Scripts/make-icons.sh, so the Mac, iPhone, iPad, Android and Linux icons cannot drift apart. - The way back to the site is a globe. It used to be the arrow leaving a box, which on the web means "this opens somewhere else" — the page arrives in the same window.
- Every button the accent touches is an outline now. A filled one reads fine until the accent is the page's own text colour — on black, "Open" was a white label on a near-white fill. The colour goes on the background it was measured against instead, and a control that is "on" fills its icon.
- Settings no longer holds article images, start page order or the reader's control edge. All three now live in the popover of the surface they change, where the effect is on screen while you choose.
Fixed
- An article's first line no longer reads grey. The fade behind the top controls was sized for a finger on every device, so on a desktop it painted 34px past where the article began. Both the fade and the headroom now follow the controls that are actually up there.
- The Mac icon sits in the Dock at the size every other app does. Its rounded tile was being scaled twice, which cropped the artwork and left it small and soft beside its neighbours.
- The "show the original page" button looks like the buttons beside it, and hides with them when the controls collapse on a phone. It was in no style rule and no id list, so the engine drew its own default button and left it on screen alone.
- The start page no longer offers to show "the original page". There is no article there and no site to go back to; the button did nothing when pressed.
0.13.0 - 2026-09-11
Added
- Turn the reader off for a site, so you can log in (#44). A paywall's sign-in form is the site's own page, and an extracted copy has no form in it. The reader's menu hands the site back and stays out of the way on that host; our own way back is injected over it, so the decision is reversible from where it was made. Travels between devices with the rest of the settings.
- Pick the colour links take (#45). Five vetted accents, each with its own shade per theme — the blue that reads on cream is not the one that reads on black. Sepia's default blue measured 4.39:1 against its background, under the 4.5:1 a link needs, and now clears it.
Fixed
- A site could turn the reader off for itself. On Android the page bridge is reachable from any document, so a publisher could have disabled the reader for its own domain — durably, and on every device the settings reach. That decision now has to come from the app's own chrome, and a page can only ever decide about its own host.
0.12.0 - 2026-09-10
Added
- Sync appearance settings and recents between devices through a folder you pick — your Nextcloud folder, iCloud Drive, anything that already syncs. Set it up in Settings (⌘,); page zoom stays local, and the Linux app has no folder picker yet.
- WebReader on iPhone and iPad (#6). Share a link from Safari or anywhere else and it opens in the same reader page as the Mac, with the same appearance settings, the same recents, and sync to a folder you pick. Built from the same reader code as the Mac app, not a second copy of it.
- WebReader on Android (#9). Open a link from any app or share one to WebReader and it lands in the same reader page as everywhere else, with the same appearance settings and recents, synced through a folder you pick. The reader logic is the same compiled code as the Mac's — ReaderKit runs natively on Android — so the two cannot drift apart. Adding a suggestion source needs the feed's own address there for now; a bare site address finds nothing.
- Choose what the start page leads with. Settings now has a Start page section: recent articles first, as before, or suggested articles first.
- A feed address offers to become a source (#43). Open one and the page says what it is and offers to add it to suggested articles, rather than only telling you there is nothing to read.
- On a tablet the reader's controls sit in the middle of an edge, behind one button, in reach of the hand holding it — the two top corners are the hardest places to reach on a screen you are holding. Settings picks the edge: right, or left.
- An article ends with three things to read next. Finishing one meant going back to the start page to find another; the same ranked suggestions the reader's popover already carried now sit at the end of the article too, and open on a tap.
Changed
- The reader itself moves into
ReaderSession(#6, #9): what the app decides — which page is on screen, when an article is extracted, what each control does — is now one implementation that every platform drives, and each host only carries the code that talks to its own web view. No change to how the Mac app behaves. - A shared link can carry a headline (#9). Sharing "Worth reading: https://…" now opens the link instead of refusing it. Pasting prose into the URL field is still refused: a paste of a sentence is more likely a mistake than an invitation to guess.
- Recents live on the start page (#32). The reader's recents popover duplicated the inline list and the hidden-text panel had no article to group against, so both leave the reader; hidden phrases move to the settings page, beside blocked outlets.
- Five recent, five suggested (#33). The reader's recents popover lists five recent articles instead of the whole history, followed by five suggestions — both with thumbnails — so you can pick up something new without going home first.
- Article images move to settings. The Aa popover's Images switch read as governing the article's own images, which it never did; it becomes an Article images section with one switch per surface. Anyone who had the old switch off gets both new ones off.
- Recents now record when an article was read, and clearing history leaves a timestamp, so two devices merge in the right order and a clear isn't undone by a device that was off. Existing lists are read as before, on both platforms.
- The pages work on a touch screen (#36). Controls reach a 44px target, popovers stay on screen and clear the safe areas, and the layout stops spending desktop gutters and 18vh of headroom on a phone. A roomy desktop window renders exactly as before.
- The reader's controls collapse behind one button wherever a hand does the reaching (#36). Six buttons over an article compete with it, and the corners are hard to reach one-handed; one button now opens them as a column. Any touch screen triggers it, and so does a narrow desktop window.
- The compact chrome says what its controls are. The button that opens them takes the three-line mark and is a little larger — the vertical ellipsis now belongs to a suggested row's own menu — and every control carries its name beside its icon, "Aa" included. A roomy window keeps the icons alone, where hovering one already names it.
- A suggested row's controls live behind one button. More, Less, Block and Hide sat beside every headline, which read as clutter and spent width the headline wanted; tapping the row's own menu now swaps them in, one row at a time, at every window size. Blocking an outlet has its own mark, and the X beside it closes the menu rather than banning the source.
Fixed
- The article you had just read was offered again at the end of it. A feed's address for
a story and the address the site redirects you to are not the same string —
dr.dk/…againstwww.dr.dk/…— so "already read" never matched and every article suggested itself, with the rest of the list barely changing. The same story carried by two feeds under two spellings also collapses into one row now. - A feed address left the app with no way out. Opening one — pasting it into Open URL from Clipboard, say — showed either nothing at all or a page made of angle brackets, with none of the reader's own chrome on it. It now says there is nothing to read there and offers Home.
- On Android a load that never landed never ended. A site that answered and then went silent left the app waiting behind a bare screen with the progress line sweeping, with nothing to do but quit it. Such a load is now given up on after 20 seconds and reported as the timeout it is, with Try Again. (WebKit raises its own timeout, so the Mac already had an ending.)
- A glimpse of the site showed before the reader replaced it. The cover came down as the reader document was handed over rather than when it appeared, so the page it was about to replace got a frame or two on screen.
- Back from an article returned to the same article (#42). The web view's history holds the page each article was extracted from, so going back through one extracted it again and landed you where you started. Back now walks the reader's own places — the previous article, or the page it came from — and from the start page it leaves the app.
- The reader's width setting did nothing on a narrow screen. Below 48rem — a phone, or a narrow window on a Mac — all three widths are wider than the viewport, so they looked identical; the setting now picks the gutter instead. The default reads exactly as before.
- Buttons stayed on screen after collapsing the reader controls (#36). Collapsing hid them but left their boxes standing, so parts of the column kept being drawn until the next window resize. The 140ms fade goes with the fix.
- Suggested-article controls were unreachable without a mouse (#36). More, Less and Block on a suggested row were revealed on hover, so they were invisible and unusable on any touch screen; they are visible by default now.
- Article text ran through the top buttons while scrolling. The gaps between the buttons let the article through, leaving a line of text crossing the icons with neither readable. A gradient that follows the theme now sits behind them.
- Page text sat under the notch (#36). The floating controls cleared the safe area from the start, but the pages' own content did not, so on an iPhone the start page's title ran behind the Dynamic Island. Only ever visible on hardware with an inset.
- On a tablet the article's first line started inside the top controls (#36). Touch grew the buttons to a 44px target without growing the headroom above the text to match, which a mouse never showed because its buttons are smaller.
0.11.0 - 2026-08-31
Fixed
- Keyboard focus (#26).
Tabnow reaches the whole page on macOS — buttons, recents rows, the appearance controls — instead of stopping at the URL field.
Added
- A way home (#15). The reader, settings and offline pages now carry a Home button in the top-left corner, aligned with the controls opposite it. On the start page that slot holds Settings, which moves up from the bottom-left corner. Settings loses its "Done" button: it sat below the fold and committed nothing, since changes there apply as you make them.
- A loading screen (#24). While a page loads, WebReader shows a plain screen with the progress line at the top instead of letting the original site paint itself only to be replaced by the reader a moment later. It picks one of fifteen short messages per load, with a highlight travelling across it — held still if the system asks for reduced motion. On a slow connection the screen stays up as long as the load keeps moving, and gives way only if nothing happens for six seconds.
- Article thumbnails (#25). Recent and suggested articles on the start page show the article's own lead image where there is one — read from the page for recents, and from the feed for suggestions. Articles without one get a placeholder rather than a blank gap, so rows stay lined up. Turn them off under Aa → No images; with them off the page requests nothing.
- A Linux app (#16). WebReader now runs on Linux as a GTK4 + WebKitGTK application,
developed against Arch/Omarchy on Hyprland. It registers as an
http/httpshandler, so the browser chooser andxdg-openroute links to it, and opens them in the same reader page as the Mac — same appearance settings, same recents, same suggestions. Installing it does not change your default browser. - The Linux app has no menu bar; the nine host commands are
Ctrl-based accelerators, chosen to stay clear of Hyprland'sSuperbindings, and they are listed on the settings page since there is nowhere else to read them.webreader --clipboardopens a URL from the clipboard and is worth a Hyprland binding, because it is most useful when the app is not focused. - On Linux the reader's automatic theme follows the active Omarchy theme rather than a system light/dark switch. Explicit themes still pin their own palette.
- Reader font stacks are now chosen per platform, so Linux gets faces that actually resolve there (Noto Serif, Adwaita Sans) instead of falling through to Liberation.
Changed
- Hiding boilerplate is now part of the reader itself: select a line and a Hide text button appears beside it. The Edit-menu and right-click routes are gone — one way to do it, and it works on a platform with no menu bar.
- Both progress hairlines read one shared thickness constant instead of two hand-kept copies.
0.10.1 - 2026-08-28
Fixed
- The start page came up inert in 0.10.0: clicking a recent article did nothing and no suggestions ever appeared.
0.10.0 - 2026-08-28
Added
- Suggested articles on the start page, ranked against what you have been reading. Ships with wallnot.dk — Danish articles without paywalls — as a source.
- A settings page (⌘,) for the suggestion sources: add a feed or a site address to look one up on, remove any of them (the shipped one included), and limit suggestions by language.
- Recents and suggestions sit side by side when the window is wide enough, and stack again when it is not.
- Tell the suggestions what you think: More/Less like this — on a suggested article or on the article you are reading — shapes what is suggested next, and blocking an outlet stops it being suggested at all. Blocked outlets are listed in Settings.
- Recent articles are kept on disk: opening one from the recents list is instant and works offline, and a failed page load falls back to the saved copy when there is one. Saved copies follow the recents list (30) and go with Clear history.
- Boilerplate lines such as "Artiklen fortsætter efter annoncen" and ad labels are removed from articles. Blocks are dropped only when their whole text matches a phrase.
- Learn new phrases as you read: select the text and pick Hide Selected Text in Articles from the context or Edit menu. A Hidden text popover lists them, each removable, with a count of what the current article lost and the phrases that hit it listed first.
- Inline quotations (»…«, “…”) are styled: a left border with the quote in medium weight, or italic — a new Quotes control in the Aa popover.
Changed
- Reload (⌘R) in the reader fetches the article page again instead of redrawing the rendered page, refreshing the saved copy.
- The reading-progress line now uses the text color instead of the accent, so it no longer looks like a stalled page load.
0.9.0 - 2026-08-25
Added
- WebReader is now its own project, split out of webwrap 0.8.0's reader mode. Feature parity with the webwrap-generated app: link handling with tracking-URL cleaning, automatic reader view, appearance controls, recents, start page, reading-progress line, offline page, and page zoom.
- One-time import of appearance settings, recents, and zoom from the webwrap-generated WebReader app on first launch.
- View → Reset Reader Appearance replaces the old Settings window's Restore Defaults.
- Release pipeline:
Scripts/release.shpublishes a signed, notarized universal build as a GitHub Release and bumps the Homebrew caskyepzdk/tools/webreader.
Changed
- New bundle identifier
dk.yepz.webreader; site logins from the old app don't carry over. - All web links now open in-window (the app is a reader for any site); non-web schemes such
as
mailto:still go to their owning app.
Removed
- webwrap-only options the reader never used: navigation toolbar, Settings window, user-agent selector, window background color.