hass-west-wood/README.md

West Wood Club for Home Assistant

A Home Assistant integration that exposes the live member count of West Wood Club gyms as sensors.

The West Wood app is a white-label build of PerfectGym Go, so this integration talks to PerfectGym's backend (https://goapi2.perfectgym.com). The API was reverse-engineered from a capture of the app's traffic; see api.md for the documented endpoints.

Features

• One occupancy sensor per club, reporting the number of members currently checked in (GET /v1/Clubs/WhoIsInCount).
• All selected clubs are grouped under a single West Wood Club device.
• measurement state class, so Home Assistant records long-term statistics and history graphs per club.
• A single poll per update interval feeds every sensor.

Getting a token

Authentication is a long-lived bearer token. Generate one with get-token.py (stdlib only — needs no dependencies):

WESTWOOD_EMAIL=you@example.com WESTWOOD_PASSWORD=... python get-token.py

It prints the token to stdout (credentials can also be entered interactively).

Installation

NixOS (flake)

This repo's flake exposes the integration as a package and an overlay. Add it as a flake input on your Home Assistant host, apply the overlay, and list it in customComponents:

# flake inputs
inputs.hass-west-wood.url = "git+ssh://git@git.nul.ie/dev/hass-west-wood.git";

# NixOS module
{ pkgs, ... }:
{
  nixpkgs.overlays = [ inputs.hass-west-wood.overlays.default ];

  services.home-assistant = {
    enable = true;
    extraComponents = [ "default_config" ];
    customComponents = [ pkgs.home-assistant-custom-components.west_wood_club ];
  };
}

Manual

Copy custom_components/west_wood_club/ into your Home Assistant config/custom_components/ directory and restart Home Assistant.

Configuration

The integration is configured through the UI:

1. Settings → Devices & Services → Add Integration → West Wood Club.
2. Paste a bearer token (from get-token.py).
3. Select the clubs to create sensors for.

If the token is later rejected, Home Assistant starts a reauth flow to paste a fresh one.

Development

See AGENTS.md for the dev environment (Nix flake + nix-direnv), code style, and working with the traffic capture.