Skip to content

Article Reader v1.0.0

Choose a tag to compare

@jp244btc jp244btc released this 11 Jul 19:28

First release. A small, self-hosted web app: paste an article URL, get a clean, popup-free, reader-mode version you can read and print — no accounts, no cloud.

Highlights

  • Fast engine (default): tiered extraction — direct fetch → headless Chromium with JavaScript disabled → overlay stripping → Wayback Machine fallback — with Mozilla-style readability isolation of the article body.
  • "Use my logged-in Chrome" mode: for sites that serve automated browsers a bot-challenge wall (e.g. the New York Times). Drives a real Chrome with a dedicated profile; log in once and your session persists.
  • Reader view with print / save-as-PDF, dark-mode aware, images and links resolved to absolute URLs.
  • An "Extraction trail" on every page showing which method recovered the text.

Install (Windows)

git clone https://github.com/jp244btc/article-reader.git
cd article-reader
py -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe -m playwright install chromium

Then double-click run.bat and paste an article URL at http://127.0.0.1:5000.

Known limitation

If a site sends only a teaser to logged-out visitors, the withheld text never reaches your machine and cannot be recovered client-side — sign in once in the dedicated Chrome window (subscription, free account, or library access) for full articles. See the README for details.