HomeGlance
← Support

Getting started

Connect HomeGlance to Home Assistant

HomeGlance connects directly to your Home Assistant instance. To get started, you need two things: your Home Assistant base URL and a Long-Lived Access Token.

1. Find your base URL

This is the address you use to open Home Assistant in a browser — for example https://homeassistant.local:8123. Include the protocol (http/https) and port.

2. Create a Long-Lived Access Token

  1. Open Home Assistant in your browser.
  2. Click your profile (bottom-left), then open the Security tab.
  3. Scroll to Long-Lived Access Tokens and click Create Token.
  4. Give it a name (e.g. "HomeGlance") and copy the token.

3. Connect in HomeGlance

  1. Open HomeGlance Settings → Connection.
  2. Paste your base URL and the token.
  3. Click Test Connection — you'll see an explicit success or failure message.

Your token is stored securely.

HomeGlance saves your access token in the macOS Keychain — never in plain text. Optional debug logs always redact tokens.

Troubleshooting

  • Double-check the URL includes the correct protocol and port (8123 by default).
  • Make sure your Mac can reach the Home Assistant instance — try opening the URL in a browser first.
  • If the token was revoked in Home Assistant, create a new one and update it in HomeGlance.

Need to start over? Use Remove Connection in Settings → Connection to clear the URL, token, and favorites.