Brett Jenkinsandrick 3c4b9ca625 Complete the keg name catalog: 86 -> 114 kegs
This is the full mapping — every keg the PerfectDraft app can select, including ones no
longer sold but which can still be sat in a machine. The same mapping drives the
seemy.beer tap sign, where it has been running well.

The ids can't be looked up in bulk, so each one was observed directly from the machine.
Every entry here is measured rather than inferred.

28 kegs previously showed no name at all in Home Assistant. Now named, among them
Kopparberg Crisp Apple, Leffe Prestige, Kwak Rouge, Hertog Jan Grand Pilsener and all
three Diekirchs.

Four existing names were wrong rather than merely styled differently:

  32814  Birra Del Borgo Lisa -> Romola          the beer was renamed, so this was
                                                 showing one that no longer exists
  44331  Short Date Ninkasi Flower Lager 6L Keg BBE June 2024   -> Ninkasi Flower Lager
  44536  Short Date Tiny Rebel Stay Puft 6L Keg BBE August 2024 -> Tiny Rebel Stay Puft
                                                 shop listings still carrying a
                                                 best-before date from 2024
  43235  Corona Cero (0.0% abv) 6L Keg -> Corona Cero (0.0% abv)   6L is the pack

Eleven other names differ only in styling (Trooper vs TROOPER, St vs Saint Feuillien).
Left alone deliberately: this is a display name, the existing spellings are the ones the
shop uses, and rewriting them would only make the diff harder to read.

File formatting is untouched (no indent, numeric key order), so the diff is just the
real additions.

(cherry picked from commit 0982d20737d22c241c736fe657b3e0d02625b50c)

Backported-from: https://github.com/brettjenkins/hassio-integration-perfectdraft-pro
Backported-via: brettjenkins/hassio-integration-perfectdraft-pro#1
2026-09-06 16:12:17 +02:00

PerfectDraft Pro for Home Assistant

A Home Assistant custom integration for the PerfectDraft Pro beer dispenser. Monitor your keg's temperature, remaining volume, pour history, and more — right from your HA dashboard.

Sensors

Sensor Description Unit
Temperature Current beer temperature °C
Keg Name of the tapped beer, resolved from a bundled catalog —
Keg Remaining Beer left in the keg %
Keg Freshness Days remaining until 30-day freshness expires days
Connection Machine connectivity status —
Door Door open/closed state —
Pours Number of pours since keg was loaded —
Last Pour Volume of the most recent pour mL
Mode Current operating mode (standard, eco, etc.) —
Firmware Machine firmware version (disabled by default) —

Installation

  1. Open HACS in Home Assistant
  2. Click the three-dot menu > Custom repositories
  3. Add this repository URL and select Integration as the category
  4. Search for "PerfectDraft" and install
  5. Restart Home Assistant

Manual

  1. Copy the custom_components/perfectdraft folder to your HA config/custom_components/ directory
  2. Restart Home Assistant

Setup

Step 1: Credentials

Go to Settings > Devices & Services > Add Integration > PerfectDraft and enter your PerfectDraft app email and password.

Step 2: Verification Token

The integration needs a one-time verification token from PerfectDraft's website. This step looks more technical than it actually is — it takes about 30 seconds:

  1. Open perfectdraft.com/en-gb/customer/account/login in your browser (Chrome, Firefox, Edge, etc.) — you do not need to log in on this page, just open it
  2. Press F12 to open Developer Tools, then click the Console tab
  3. Paste this command and press Enter:
grecaptcha.enterprise.execute('6LcZQiUoAAAAAAO3JUjLiT470c-pNXbWyepuvMtV', {action: 'Magento/login'}).then(t => console.log(t))
  1. A long string of text will appear in the console — that's your token
  2. Select it, copy it, and paste it into the Home Assistant setup dialog
  3. Click Submit within 2 minutes (the token expires)

That's it! The integration will authenticate and start polling your PerfectDraft Pro. Token refresh is automatic — you should not need to repeat this step. If the session does eventually expire, Home Assistant will prompt you to re-authenticate. (This is a new integration, so the exact session lifespan is still being determined — it's at least 30 days and may well be indefinite.)

Step 3: Configure polling

After setup, you can adjust the polling interval in the integration's options. Default is 15 minutes; minimum is 1 minute.

Companion Card

The PerfectDraft Card is a custom Lovelace card that visualises your keg data as a beer emoji pictogram — see at a glance what's on tap, how cold it is, and how many glasses remain. Designed for wall-mounted panels (Sonoff NSPanel Pro), works on any HA dashboard.

PerfectDraft Card showing Leffe Blonde at 3°C with 18 glasses remaining

Install via HACS (Dashboard category) or see the card repository for details.

How It Works

The integration communicates with PerfectDraft's cloud API to read your machine's telemetry data. Token refresh is handled automatically via AWS Cognito — no reCAPTCHA needed after the initial setup.

For the full technical story of how this integration was reverse-engineered, see DISCOVERY.md.

S
Description
An attempt at integrating Philips PerfectDraft Pro
Readme
829 KiB
Languages
Python 98.6%
Shell 1.4%