# Brevier — a browser for reading

gurov

![The same Guardian article twice. First in Chrome: the text squeezed into a narrow column between a video, an advertisement and a fundraising banner across the bottom of the screen. Then in Brevier: the same text in one calm column on ivory paper, with the contents and the site's sections on the shelf.](https://brevier.bizibah.com/hero.webp)

Before and after. The dragons stay outside.

## The tale in chapters

1.  [Once upon a time, the web was a library](#library)
2.  [The dragons move in](#dragons)
3.  [A small book with a big job](#name)
4.  [The reading room](#reading-room)
5.  [The library tower](#tower)
6.  [Ravens from distant towers](#ravens)
7.  [The chronicle that does not burn](#chronicle)
8.  [When the gate stays shut](#gates)
9.  [For castle builders](#builders)
10. [What the hero leaves at home](#left-at-home)
11. [Your treasure, your chest](#treasure)
12. [Choose your mount](#mounts)
13. [Join the quest](#quest)

## PrologueOnce upon a time, the web was a library

Once upon a time, the web was a quiet library. Every page was a scroll. You unrolled it, you read it, you rolled it up again. Scholars wrote them, curious people read them, and nobody had to accept any cookies to get through the door.

It was not a beautiful library. The scrolls were written in every hand imaginable, some in bright green on purple. But the words were there, and you could reach them.

Then the dragons moved in.

## Chapter oneThe dragons move in

They did not arrive all at once. First came a small one that asked, very politely, whether you would like to subscribe. Then one that played a video nobody had asked for, with the sound on. Before long the library was full of them:

- **The Cookie Wyrm** sits on the doorstep and will not move until you have clicked through forty-two switches and agreed to all of them.
- **The Newsletter Basilisk** waits until you are halfway down the page, then stares at you from the middle of the screen.
- **The Autoplay Hydra.** Close one video and two more start in the corner.
- **The Infinite Scroll Serpent** has eaten the footer of every page it ever met.
- And above them all, **the Great JavaScript Dragon**. Once a humble helper, it no longer brings you the page at all — only a cart of bricks and a book of instructions. It builds the castle in front of you while your laptop fan howls and your battery quietly weeps.

Readers still came for the scrolls. They just had to fight their way to them.

## Chapter twoA small book with a big job

In the early days of printing, *brevier* was the name of a small size of type — small enough to fit a whole book of daily readings into a traveller's pocket. People carried those little books everywhere.

Brevier the browser is that pocket book for the web. It does one thing: it reads. It walks past the dragons, takes the scroll, and brings it back to you on clean paper.

The trick is simple. Brevier never lets a dragon in, because it never runs JavaScript — not a little, not for one special site, not ever. It downloads the page, finds the article inside, turns it into Markdown on your own computer, and sets it again in its own typography. **The site decides the words. You decide how they look.**

## Chapter threeThe reading room

Every page you open arrives in the same calm room:

- **The same type on every site** — Noto Sans at a comfortable size, about 65 characters to a line, headings lighter than the text. Settings for face, size and measure are on the roadmap.
- **Ivory paper** instead of glaring white, and a warm dark theme for the night watch.
- **Hyphenation by the page's language**, so the right edge stays calm.
- **Zoom from 67% to 200%** that scales the whole layout, so a line still holds about 65 characters.
- **Poems keep their lines and stanzas.** Even bards are welcome.

![Dan Luu's essay on keyboard latency in Brevier's light theme: dark text on ivory paper in a hyphenated column, two quotations set off by a rule, and on the right the shelf with the contents, the current section highlighted.](https://brevier.bizibah.com/reading-light.png) ![The same page in the dark theme: light text on a warm, nearly black background.](https://brevier.bizibah.com/reading-dark.png)

An essay on keyboard latency, by day and by candlelight.

## Chapter fourThe library tower

Some of the best scrolls on the web live in git repositories: manuals, books, guides. Type `gh:owner/repo` in the address bar and Brevier opens the README, with the project's documentation laid out on a shelf at the right. `gl:` works for GitLab. End the address with a slash, and you see what the folder holds.

The same shelf shows the contents of any long page and marks the section you are reading, so you never lose your place in a tall tower of text.

![The Rust book's chapter on data types, opened as gh:rust-lang/book/src/ch03-02-data-types.md: the chapter's text and a code example on the left; on the shelf, the repository's documentation, Contributing and the files in the directory, then the chapter's sections.](https://brevier.bizibah.com/repository.png)

The Rust book, straight from its repository.

## Chapter fiveRavens from distant towers

Feeds are the ravens of the web: RSS, Atom and JSON Feed. Brevier opens them as lists of entries with the date, the author and a short summary. A `feed://` link works, and so does a feed saved as a file. A raven that carries the comments of one page reads as a conversation.

Anything you type that is not an address becomes a search on DuckDuckGo, and the results come back as a plain list of links. No raven was harmed.

![The Rust Blog feed as a list: each entry's title as a link, the date and the authors, then a short summary.](https://brevier.bizibah.com/feed.png)

A feed is a list of things to read, so that is how it looks.

## Chapter sixThe chronicle that does not burn

Every article you read is copied into your own archive: plain Markdown, compressed, one file per page. `Ctrl+Shift+F` searches all of it. When a site changes its mind — or vanishes into the mists — your copy is still on your shelf.

Long reads remember where you stopped. Come back to a page you read for ten minutes or more, and Brevier offers **Continue from 43%**. It does not jump on its own; heroes like to choose. A thin line under the text shows how far you have come.

And if a page is truly gone, Brevier can fetch the last good copy from the Wayback Machine — but only when you press the button. Until then, archive.org hears nothing about what you read.

 ![Dan Luu's essay on keyboard latency opens at the top; the status line says “You have read part of this page before” and offers Continue from 43%. One click, and the text moves to where the reader stopped, with that section marked on the shelf. Then Ctrl+Shift+F, the word “display” typed into the address bar, and the archive answers with three pages and a snippet from each.](https://brevier.bizibah.com/continue.webp)

Picking up the thread, and finding the old scroll.

## Chapter sevenWhen the gate stays shut

Not every castle opens. Some sites are built entirely out of JavaScript, and some keep an anti-bot wall at the gate. Brevier knocks politely, gives its honest name, and never climbs the wall. When the gate stays shut, it says so plainly and offers **Open in your browser** — or press `Ctrl+O` — and the page goes to your other browser.

Pages that travel over plain `http` are marked *Not secure*. There is no padlock icon on the others, because a padlock only means the road was private, not that the castle is friendly.

On our own test set of 108 live pages, 80 read well. Not every quest ends in victory; we publish the score anyway, and how we counted it.

![Brevier's page for an address where nothing lives: “The page is not there”, a note that you read the page on 9 October 2026 and your archive keeps a copy, and three buttons: Open your copy, Read the Wayback copy, Open in your browser.](https://brevier.bizibah.com/gone.png)

Even a closed gate comes with directions.

## Chapter eightFor castle builders

If you build websites, Brevier can tell you how yours looks to a reader who runs no scripts. `brevier --check https://your.site/` gives a score from 0 to 100, says what to change, and prints the arithmetic — so you can argue with a number instead of a mystery.

There is a GitHub Action too. It writes the report into the job summary and fails the build when a page falls below your mark:

```yaml
- uses: gurov/brevier@main   # or a release tag
  with:
    urls: |
      https://example.com/
    min: 80
```

![The check report for example.com: a score of 73 out of 100, the sum behind it, and the findings stage by stage, each saying what to change.](https://brevier.bizibah.com/check.png)

A report card for your castle, with the sums shown.

## Chapter nineWhat the hero leaves at home

A good adventurer packs light. Brevier will not carry:

- **JavaScript.** Never, in any form. That is the whole point.
- **The site's CSS.** The type is yours.
- **Forms, logins and cookies.** Here the web is read-only, on purpose.
- **Video, audio and extensions.**
- **An AI model.** It would add hundreds of megabytes, take seconds per page, and might put words in the author's mouth.

And one honest limit: **screen readers work on Linux only** for now. GTK's accessibility does not reach Windows yet, and on Android TalkBack should read the native text, but nobody has tried it yet. We would rather tell you here than let you find out the hard way.

## Chapter tenYour treasure, your chest

History, open tabs and bookmarks are plain text files, one line per entry. Delete a line to forget a page. The archive is Markdown in the standard LZ4 format, so `lz4 -d` opens it without Brevier. There is no database and no account.

Brevier itself counts nothing and sends nothing home. Sites can still see that you visited them, as they always could — Brevier is a reader, not an invisibility cloak.

## Chapter elevenChoose your mount

### Linux

A [Flatpak](https://github.com/gurov/brevier/releases/latest/download/brevier.flatpak) that works on any distribution, or a tarball for systems that already have GTK 4.

### Windows 10 and 11

An installer that sets Brevier up for you alone, with no administrator rights, or a zip that runs from any folder. The installer is not signed yet, so Windows first says *Windows protected your PC*: choose **More info**, then **Run anyway**. Dragons have made Windows a little nervous.

### Android 7 and later

A native app over the same core — it draws the article as real text, not in a web view — with tabs, the shelf, find on page and the dark theme. Download the APK from the releases; an F-Droid listing is under review.

### The command line

`brevier https://example.com/article` prints the article as Markdown. Scrolls for scripts.

- [Download the latest releaseLinux · Windows · Android](https://github.com/gurov/brevier/releases/latest)

![Brevier on an Android phone, two screens side by side: an article from anthropic.com with bar charts and their caption in the reader's type; and the same page with the shelf open, listing the article's sections and the site's pages.](https://brevier.bizibah.com/android_1.jpg) ![Brevier on Windows: an article from The Verge with its headline, byline and illustration; the shelf on the right lists the site's sections.](https://brevier.bizibah.com/windows.jpg)

The same reading room in your pocket and on Windows.

## EpilogueJoin the quest

Brevier is free software under MIT or Apache-2.0, built in the open on [GitHub](https://github.com/gurov/brevier). Reports from the field are welcome in the [issues](https://github.com/gurov/brevier/issues), and so are patches — as long as they do not bring a dragon with them. The [manifesto](https://github.com/gurov/brevier/blob/main/MANIFESTO.md) says what Brevier promises, and the [roadmap](https://github.com/gurov/brevier/blob/main/ROADMAP.md) says where it is going next.

New releases arrive by raven: [the releases feed](https://github.com/gurov/brevier/releases.atom).

❦ ❦ ❦