LivingKioskUse now
← All displays

Hearth

A wood fire in a brick hearth, close up: flames licking up from behind the logs, embers breathing in the cracks, and a burst of sparks now and then when a log settles. The flames are a shader, not a video loop — eight tapering tongues torn at the tips by rising turbulence and coloured along a blackbody ramp from ember red to near white — and the brick and floor take a warm light that swells and flutters with the fire. There is no audio, and nothing is fetched.

Hearth with oak logs: a stack of dark brown logs on a grate before a dark red brick wall, several orange flames rising from behind them, a few faint sparks above, and glowing orange log ends and embers at the base.
OakDark, deeply barked logs: the default.
Hearth with birch logs: pale cream logs with short dark papery marks stacked before the same brick wall, lit golden along their upper sides by the flames rising behind them.
BirchPale, papery logs, lit brighter by the same fire.

A seed lays a whole fire

The stack of logs, the spacing of the tongues and the order of the sparks all come from the seed, and the fire’s footprint is worked out from wherever the logs ended up, so any stack gets a fire that fits it. A mask over the logs hides the flames’ feet, so they rise from between the logs rather than sitting on top of them.

If you self-host

Self-hosted, read-only container. Hearth makes no outbound request and plays no sound; every frame is computed in the browser, with the shader at 75% resolution and the frame rate capped at 30.

What it wants

Oak or birch logs, a flame height from a banked glow to a roaring fire, and sparks on or off. Sizes come from the screen’s own shorter side, and the set is repainted when the window is resized.

Setup

Put Hearth on a screen.

A browser is genuinely enough — the Mac app 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

LivingKiosk app
  1. Get the app and its install steps at livingkiosk.com/mac. It isn’t notarized yet, so macOS asks you to approve it once.
  2. Menu bar → Library… and pick a display for each screen.
  3. Configure… on any screen for its reload schedule, dim, and saved configs.
See the Mac app →

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 hearth.livingkiosk.com/setup.

ParameterDefaultMeaning
flame1How tall the flames rise, 0.4–1.6. Below 1 is a low, banked fire; above 1 is a roaring one. Clamped, not rejected.
woodoakbirch. The logs on the grate. Oak is dark and deeply barked; birch is pale with dark papery marks.
sparksonoff removes the sparks drifting up off the fire, including the odd burst when a log settles.
speed1A multiplier on the pace of the flames, the flicker and the sparks, 0.3–2. Clamped, not rejected.
dim0Neutral darkening overlay, 0–0.8 (fleet-wide convention).
seed—Pins how the logs are stacked and the tongues of flame, so the same URL always lays the same fire.

Hearth is open source under the MIT licence. Run it yourself with one command. The source opens to the public soon.