Repository navigation
Releases
v2.1.0
Kegwall 2.1 is a polish release on top of the 2.0 redesign: the admin gets real contrast and
carries each beer's own color through every page, and the walls, kiosk, phone menu and
leaderboard put the beer on screen at full strength. No feature is removed.
Before you upgrade:
-
The database gains a
kegs.kicked_atcolumn. It's added and backfilled automatically on
start (from each kicked keg's last pour); there's nothing to run. -
Public pourers (
GET /api/public/pourersand the kiosk's "Who's pouring") now include each
person's last beer (name and color). Keg cost still never appears in any public response. -
Fixed: Insights "kegs kicked" counts kegs by the day they were kicked instead of kicked
kegs that were poured from in the range. -
Fixed: a nearly empty keg with no recent pours reads "almost out" on Taps instead of a
dash, shows under Tonight's "Next to kick", and is boarded first (not last) on the Departures
look. The "Needs a swap" chip counts every tap that shows a Swap keg button. -
Fixed: Doctor names sources plainly ("Kegtron cloud", not
kegtron_cloud), Automations
reads "notify in the app" instead of "notify inApp", Notifications hides "Mark all read" when
nothing is unread, and the swap wizard's steps no longer wrap. -
Fixed: walls with no paired screen show their address on Tonight, so identically named
walls can be told apart. -
Fixed: at the end of a full pour on the Full and Tap Pull takeovers, the head now rises to
the rim and spills over. A shorter pour no longer shows foam spilling over an empty rim. -
Fixed: the Dock takeover keeps the wall's header on screen: the wall shrinks toward the top
to make room for each pour's bar instead of sliding up and off. -
Fixed: the phone menu's Find yours claim button is a full 44 px touch target again.
-
Changed: the admin has real contrast: a dark frame, each page on a warm charcoal sheet, every
list on its own lighter panel, and copper reserved for the one main action and for what is
happening now. A strip of the beers on tap runs under the top bar. -
Changed: Tonight shows taps as glasses in the beer's true color with a foam line, a caution
edge when low and an outline when kicked; to-dos are ranked by weight and the hours chart
prints each hour's count. -
Changed: level bars are sight glasses with quarter marks, and the Classic look and every
level bar use the beer's true color, with the words switching ink at the liquid line. -
Changed: Taps rows carry a tap-handle edge in the beer's color and open on click; the
drawer opens on a band of that color and the page leads with pints left and taps needing a swap. -
Changed: Beers is a cellar ledger grouped On tap, On deck and In the cellar, with
a dashed edge on a beer with no color set. -
Changed: People ranks pourers with tally marks colored by the beer they pour most, beside a
strip of what they drink. -
Changed: Settings uses switches and styled selects, puts each group on its own panel and
shows Save only once something changed. Monitors keeps Change tap in view and moves Unbind and
Reset volume into a row menu; Automations' Delete moves into the rule's editor; Doctor lists
down sources first. -
Changed: Insights charts share one style and make their point: the busiest weekday is
labelled, keg depletion is one ranked list of kegs filled with their beer, the temperature chart
shades the serving range, highlights read as sentences, and pours are grouped by night. -
Changed: Search finds taps and beers as well as pages. The notification panel opens with a
sentence, marks severity by shape as well as color, and closes with Escape. -
Changed: Screens → Walls shows each wall as a small live TV of its own taps with a power
light. The Wall Editor's preview hangs on a wall tinted by the leading beer, with a light that
stays amber until you save. The pairing screen is readable from the couch, Presence shows each
wall as a lamp, and Games reads as a specials board with the live game on top. -
Changed: the kiosk shows every tap handle in its beer's color, a flowing tap floods the
screen with its beer, and the "Who's pouring" tabs carry each person's last beer. -
Changed: the leaderboard is a tally board: tally marks per pourer, a strip of their beers,
the leader's row larger, and superlatives as sentences. It's still the one leaderboard. -
Changed: on the phone menu, each row's edge drains with the keg, the beer sheet opens on
the beer's color, and there's one way to claim a pour. -
Changed: on the TV, a finished pour sweeps its beer across the takeover, the Dock bar fills
as the ounces climb, Zen fills its disc with the featured beer, Tally strikes every fifth
mark, and Chalkboard gets its own slate background. -
Changed: sign-in and first-run setup show the bar's taps as columns of beer at their levels.
v2.0.0
Kegwall 2.0 redraws every screen in one design language: the TV wall (14 looks, each showing
what's left as a picture and in pints), the pour takeovers, the admin, the Wall Editor, the phone
menu and the kegerator kiosk. No feature is removed and no stored data is migrated.
Before you upgrade:
-
Every wall changes appearance: the looks are redrawn from their names. Stored wall settings are
kept as they are, so reinstalling 1.17 brings every wall back unchanged. -
Custom CSS that targets the pre-2.0 wall class names (
.tap-card,.ledger-lookand the other
per-look classes,.wall-header,.ticker,.qr-overlay) no longer matches. Use the
[data-look],[data-tap-state]and[data-surface]hooks; see
Customizing walls. -
Themes now change color only; every theme uses the Kegwall type (Big Shoulders Display and
Atkinson Hyperlegible). -
The admin Appearance setting is gone: the admin is dark, or light when the device prefers it.
-
Changed: the admin opens on Tonight instead of the dashboard: a sentence about the
night, what needs doing, the last pour, every tap as a glass with servings left, pours by hour,
screens, hardware, the next kegs to kick and the latest activity. -
Changed: the admin has a top bar instead of a sidebar: six destinations (Tonight, Taps &
kegs, Beers, People, Screens, Insights), Search, the notification bell, Settings and an account
menu. A destination's pages show as tabs under the bar; every existing admin address still
works. On phones the destinations open from Menu as a sheet. -
Changed: one admin design, dark by default and light when the device prefers it.
-
Changed: Taps & kegs is rebuilt. Taps is one table with what's left in servings, the
kick forecast and the bound monitor, filter chips (needs a swap, due for cleaning) and a drawer
per tap for cleaning, on deck and kicked history. Swapping a keg runs in a drawer that offers
the tap's next-up keg and another keg of the same beer first. Kegs shows costs as numbers over
one table with editing in a drawer; Suppliers lists each supplier's week at a glance beside its
price book; Monitors says whether each device is receiving and maps each port to its tap. -
Changed: Beers is a library of cards with each beer's marker and where it is (on tap
with its level, on deck, or in the library), with search and filters. The editor opens in a
drawer with a live preview of the beer's marker. -
Changed: Settings lists its sections down the side (Taproom, Kegtron and sources,
Integrations and alerts, System) with a line on what each holds; "Saved." appears as a short
confirmation in the corner. Automations reads each rule as one sentence ("When a keg drops
below 15%, notify in the app.") with an On, Off or Just ran state beside it and a switch to
turn it off. Diagnostics leads with the connection doctor's verdict, and Notifications says
how many are unread. -
Changed: Insights opens Analytics with a sentence about the range and KPIs set as
large numbers; the range switch and tabs sit under it. Every pour says how many of tonight's
pours have no name, and Logs counts the problems in the range. -
Changed: People names this month's leader, shows each pourer as a card with their pours
and volume, and lists accounts with what each role can do. Adding and editing someone happens
in a drawer that first asks whether it's an account or a pourer. -
Changed: pour takeovers are rebuilt. Full shows a glass filling from a stream of beer,
Split slides a panel in the beer's color, Dock lifts the wall for a filling bar, Fill floods
the screen, Spotlight lifts the pouring card, and Off keeps the wall still with a live
counter on the pouring row. Every style handles several taps pouring at once, one lane each. -
Changed: the Chalkboard, Editorial, Neon, Terminal, Poster, Departures and Zen looks are
redrawn from their names, each showing what's left as a picture and in pints: chalk tally
gates, a magazine contents page with level rules, neon rings, ASCII gauges with the pour
log, a festival line-up, a split-flap board sorted by kick time, and an orb. -
Changed: every part of a wall (rotation, leaderboard view, banners, game strip, pour
takeovers, screensaver) scales with the screen the same way, so a 4K TV no longer needs
the browser zoom workaround. -
Changed: the Classic, Ledger, Columns and Gallery wall looks are redrawn. Every card,
row, column or plate is the keg itself, filled in the beer's color, with what's left stated
in pints ("≈ 32 pints left") using the taproom's serving size. Classic picks its layout by
tap count (large cards, two rows of cards, or board rows). Existing walls on these looks
change appearance on upgrade. -
Changed: redrawn looks render on a fixed 1920 × 1080 layout scaled to the screen, so
720p, 1080p and 4K TVs show the same composition with no white band at 720p and no
overlapping names at 4K; text is never smaller than 22 px at 1080p. -
Changed: themes keep their colors, but secondary text and warning colors on redrawn
looks are adjusted to meet WCAG contrast in every theme. -
Changed: TVs, phones and kiosks download only their own screen's code and styles. A wall
now loads 88 KB of CSS instead of 230 KB, and 237 KB of JavaScript instead of 374 KB; the
admin's styles load only with the admin. -
Added: the redrawn phone menu: the newest keg leads in its own color, search, style
family chips (Light, Hoppy, Dark, Sour), one row per beer with the name on its own line, and a
beer sheet with the description, rating, kick forecast and that tap's unclaimed pours. -
Added: the redrawn kiosk: bigger avatars and tiles for wet hands, and armed / pouring /
done as one screen with a glass that fills by the measured volume. -
Added: sign-in and first-run setup in the admin look, with one progress bar across setup
and the welcome wizard. -
Added: the Wall Editor studio: a rail of eight sections with a dot on each changed
one, a live 16:9 stage of the wall's own taps (Wall / Live pour / Screensaver, Fit / 100%,
page picker), a 14-look gallery with pictures, theme swatches, per-section Undo, Discard
changes, and a prompt before leaving with unsaved changes. -
Added: Screens pages on the new template: Walls as cards (look, what it does, which
paired screens show it, live view), Displays (Pair a screen, look and takeover overrides by
name), Presence (zones, sleep timers, motion sources and webhook, each zone named by wall and
address) and Games. -
Added: Ctrl K / ⌘K opens Search from anywhere in the admin: type part of a page's
name, arrow to it and press Enter. Editors and viewers never see admin-only pages there. -
Added: three pour takeover styles: Tap Pull (a handle swings, the glass fills and
slides off), Keg Drain (the keg empties live, pints left count down) and Game On
(the pour moves the pourer up a running game). -
Added: a Cheers finish for single full-screen pours, with the pourer's passport
pour number. -
Added: opt-in wall moments: Just kicked, Just tapped and Pour milestones (the house's
every-100th pour and each pourer's own hundreds). -
Added: two new wall looks: Tap Handles (each tap a handle in its beer's color with a
sight glass; the pouring handle tips forward) and Tally (the night as a sentence, every
keg's pints left as tally marks). -
Added: prices on the Chalkboard look when pricing is turned on.
-
Added: the Just Tapped wall look, the default for new walls: the newest (or a
pinned) keg fills half the screen in its own color, with the tap list beside it. -
Added: tap markers (the beer's color, initials and tap number) on every redrawn look;
uploaded label art replaces the initials. -
Added: stable custom-CSS hooks:
[data-look],[data-surface="wall"],
[data-tap-state]and[data-testid="tap-marker"]. -
Added: every tap in the live wall feed now carries tonight's pours and volume (since
4 am), pours in the last hour and a projected kick date, and the wall and menu payloads
carry the taproom's serving size. None of it reveals keg cost. -
Added: current screenshots in the README and docs (every wall look, the pour takeovers,
Tonight, Taps & kegs, Beers), generated from the app bynpm run docs:images. -
Removed: the admin Appearance setting (Midnight Slate, Workshop, Console). A saved
choice is ignored. -
Fixed: the phone menu's claim sheet was see-through on the default theme; every sheet is
now opaque. -
Fixed: phone menu names squeezed into two-word lines beside the style and ABV columns.
-
Fixed: the kiosk didn't say when it couldn't get the taps ready for a pourer.
-
Fixed: a screen's look override accepted only 4 of the 14 looks and 6 of the 9 pour
styles; choosing any other was rejected. -
Fixed: unpairing a screen happened on one click; it now asks first. Pairing codes are no
longer shown to viewer accounts on the Displays page. -
Fixed: starting or ending a game failed silently; the error is now shown.
-
Fixed: walls with the same name couldn't be told apart on the Presence page.
-
Fixed: Analytics showed an average pour quality of 0 when no pour had a quality
score; it now shows — and says there's no Kegtron quality data yet. -
Fixed: Needs attention listed one row per tap for the same problem (eleven "Tap N is
due for a line cleaning" rows buried a source that was down). Each kind is now one row with one
action, ranked problem, then caution, then information. -
Fixed: the end of a pour showed the last live reading instead of the recorded volume,
which could be several ounces short w...
v1.17.0
1.17.0 (2026-10-22)
This release moves Kegwall to GitHub and turns the admin Pours page into a full pour history.
Installs from before the move need a one-time switch — see
Moving an existing install to GitHub.
- Changed: source, releases, and the Docker image now live on GitHub —
https://github.com/dlommm/Kegwall, release downloads on the Releases page, and the image at
ghcr.io/dlommm/kegwall(latest+ each version, amd64 + arm64). - Changed: Settings → System → Check for updates reads the GitHub Releases feed and links
each release's notes on github.com. - Changed: the native installer and unattended-install ISO fetch from GitHub. Re-running the
installer over an existing install re-points it at GitHub and refreshes release tags; the in-app
updater now force-refreshes tags. - Added: every release attaches the unattended-installer ISO (with a
.sha256) and, once a
signing key is configured, the tablet APK —releases/latest/download/…always resolves. - Added: the Pours page lists every pour, newest first, with Unclaimed only,
Drinker, and From/To filters applied on the server, Load older pours paging,
relative times, and all-or-nothing bulk assign/unclaim. Every admin assignment is logged under
the Pours source. - Added:
PATCH /api/pours/drinkerfor bulk assignment;GET /api/poursaccepts
since/until/beforeId. - Added: the dashboard lists taps whose line-cleaning reminders are ignored, each opening that
tap in Taps & kegs. - Changed: admin pages show their own title and name the browser tab after the section; the
mobile menu closes on Escape and on any navigation. - Fixed: after a restart, the Kegtron cloud backfill no longer re-records pours already saved
live, and a replayed older pour is never credited to whoever is signed in at the tablet.