LivingKioskUse now
← All displays

Passage

One public-domain poem at a time, set as large as it can be while still fitting the glass, changed quietly every couple of minutes. Twelve hundred poems by thirty poets, all long out of copyright, all inside the image — Passage never makes an outbound request while it is running.

Passage on the paper ground: a Shelley fragment set in EB Garamond, filling the screen, with the title and poet in small capitals beneath it.
PaperWarm ground, for a room with daylight in it.
Passage on the ink ground: an Emily Dickinson poem set in warm white on near-black, with the title and poet in small capitals beneath it.
InkThe same setting for a room that is not.

Where the poems come from

PoetryDB, which draws on Project Gutenberg. Every poet died long enough ago that their work is in the public domain, and the selection is an explicit list rather than whatever an API returns.

Where it runs

Self-hosted, read-only container, no database and no network. The whole collection is a file inside the image — nothing upstream can disappear or start charging.

What it wants

A screen you read rather than watch. Each poem is measured and set at the largest size that still fits, so a couplet is set huge and a long ode smaller; nothing is ever cut off.

Setup

Put Passage on a screen.

A browser is genuinely enough — Plash and Fully Kiosk below are conveniences, not requirements.

Any screen

nothing to install
  1. Open the display in whatever browser the screen already has.
  2. Go full screen: F11 on Windows and Linux, ⌃⌘F on macOS.
  3. Or give it a browser of its own, which is what a dedicated panel wants: chrome --kiosk <url> — on macOS, open -a "Google Chrome" --args --kiosk <url>.
  4. Turn off display sleep in the machine’s power settings and walk away.

Mac desktop

via Plash
  1. Install Plash from the Mac App Store — it renders any web page as your desktop wallpaper.
  2. Menu bar icon → Open URL… and paste the display’s address.
  3. Leave Browsing Mode off so clicks pass through to your desktop as normal.
  4. Plash reloads on wake, so it recovers on its own after sleep.
sindresorhus.com/plash →

Wall tablet

via Fully Kiosk
  1. On any Android tablet, install Fully Kiosk Browser.
  2. Settings → Web Content → Start URL: the display’s address.
  3. Under Device Management, keep the screen on and set a dim schedule so it isn’t glaring at 3am.
  4. Turn on Start on Boot so a power blip brings the display back by itself.
fully-kiosk.com →

Displays are ordinary web pages, so anything that can hold one open works: a Raspberry Pi on a monitor, a retired iPad, a Fire tablet, the browser built into a TV.

Configuration

URL parameters.

Everything below, plus a live preview and a URL builder that writes the link for you, is at passage.livingkiosk.com/setup.

ParameterDefaultMeaning
dwell120Seconds each poem stays up (15–3600).
themepaperink or dusk.
alignleftcentre instead — left keeps a hanging indent on wrapped lines.
lengthanyshort (6–16 lines) or long (17–40).
poetsallComma-separated surnames.
placardonThe title and poet beneath the poem.
seedPins the walk, so two screens stay in step.
dim0Black scrim over everything, 0 to 0.8 (fleet-wide convention).

Passage is open source under the MIT licence. Run it yourself with one command — the repositories go public at launch.