HA Flick

A macOS menu bar app for controlling Home Assistant lights.

Features

• Toggle lights on/off from the menu bar
• Brightness slider for dimmable lights
• Group lights into collapsible sections
• Custom ordering via drag-style edit mode
• Choose which lights to show or hide
• Launch at login
• Polls Home Assistant every 5 seconds to stay in sync

Install

Homebrew

brew tap knowald/ha-flick
brew install --cask ha-flick

Manual

Download the latest HAFlick.zip from Releases, unzip, and move HA Flick.app to /Applications.

Build from source

Requires Swift 5.9+ and macOS 14+.

just run       # build and run
just app       # build universal .app bundle
just install   # copy .app to /Applications

Setup

Create a config file with your Home Assistant URL and a long-lived access token:

mkdir -p ~/.config/ha-flick
cat > ~/.config/ha-flick/config.json << 'EOF'
{
  "url": "http://homeassistant.local:8123",
  "token": "your-long-lived-access-token"
}
EOF