hedgiemate/notifier repository overview

⁠HedgieMate Notifier

A lightweight Go sidecar that monitors TeslaMate MQTT topics and sends push notification events to the HedgieMate relay server. Designed to run alongside your TeslaMate Docker stack.

⁠How It Works

1. Connects to your TeslaMate MQTT broker
2. Monitors vehicle state topics (driving, charging, battery, geofence, etc.)
3. Detects state transitions (e.g., charging started, drive ended)
4. Sends events to the HedgieMate relay server, which delivers push notifications to your iOS device

⁠Prerequisites

• A running TeslaMate instance with MQTT broker (Mosquitto)
• A HedgieMate user token (generated in the HedgieMate iOS app under Settings > Push Notifications)

⁠Quick Start

⁠Docker Compose (recommended)

Add the notifier to your existing TeslaMate docker-compose.yml:

services:
  hedgiemate-notifier:
    image: hedgiemate/notifier:latest
    restart: unless-stopped
    depends_on:
      - mosquitto
    environment:
      HEDGIEMATE_USER_TOKEN: "hm_your_token_here"
      MQTT_HOST: "mosquitto"
      MQTT_PORT: "1883"
      CAR_IDS: "1"
      LOG_LEVEL: "info"

Then run:

docker compose up -d hedgiemate-notifier

⁠Docker Run

docker run -d \
  --name hedgiemate-notifier \
  --restart unless-stopped \
  -e HEDGIEMATE_USER_TOKEN="hm_your_token_here" \
  -e MQTT_HOST="your-mqtt-host" \
  -e MQTT_PORT="1883" \
  -e CAR_IDS="1" \
  hedgiemate/notifier:latest

⁠Build from Source

go build -o hedgiemate-notifier .
HEDGIEMATE_USER_TOKEN=hm_xxx MQTT_HOST=localhost ./hedgiemate-notifier

⁠Configuration

All configuration is via environment variables:

⁠Supported Events

⁠Multiple Cars

Monitor multiple vehicles by setting CAR_IDS to a comma-separated list:

CAR_IDS=1,2,3

Each car has its own independent state machine.

⁠Architecture

MQTT Broker ──> MQTT Client ──> State Machine ──> Event Emitter ──> Relay Server ──> APNs ──> iOS
                                (per car)         (5s debounce)     (HMAC signed)

• MQTT Client: Subscribes to TeslaMate topics, auto-reconnects on connection loss
• State Machine: Tracks per-car state, detects transitions, manages battery threshold flags
• Event Emitter: 5-second debounce window, prevents duplicate events
• Relay Client: HMAC-SHA256 signed requests, 3 retries with exponential backoff

⁠Changelog

See the GitHub Releases⁠ page for release notes, or CHANGELOG.md⁠ in the repo.

Disclaimer: This project is an unofficial community tool and is not affiliated with, endorsed by, or supported by the official TeslaMate project.

⁠Changelog

⁠v1.5.0 — 2026-06-25

New: Sentry Mode recording notification

Full Changelog: https://github.com/LukStankovic/hedgiemate-notifier/compare/v1.4.7...v1.5.0⁠