🏠 Home Assistant optin ha
ha turn off the kitchen light | anything after ha goes to HA’s own assistant |
ha · ha test | connection & outputs status · ring every output now |
ha cal 3 | push dated task 3 onto the house calendar (🏠 button on /cal too) |
Your timers & reminders also ring the house — a voice satellite speaks them, a script
can sound a siren, phones get a push. The owner pairs HA in Settings → Home Assistant.
Dashboards: GET /api/ha/summary + a read-only token (Settings → Security) feeds HA sensors —
counts only, ?titles=1 to opt content in. Recipes in the manual.
⚡ Speed Dial owner-managed
1 … 9 · dial 3 | a pad-holder fires that number’s command · 0/pad shows the pad |
sd @sam 1 = turn off the lights | owner: set number 1 (label it with Label | command) |
sd @sam limit on | owner: lock @sam to the pad only · off to unlock |
sd @sam test 1 | owner: test-fire · sd @sam views a pad · sd lists all |
Give someone a handful of Home Assistant buttons without the run of the house — they send a
digit, only your predefined command runs. In Settings → Access (expand an account) you can also add a
second OFF command so one number toggles on↔off, and Generate a no-login remote-control link
(1/7/30-day, revocable) to text a guest with no Telegram. For family who never use Telegram, add a
local account (a name, not an @handle): pad-only, never reaches the bot, and its remote link may be
minted never-expiring — the link is their account. Needs the HA connection (Channels tab).
🌐 The Web App — for more control
/web | type it in Telegram or Slack → a one-time sign-in link that opens Fanad
in your browser, already signed in as you. It works once and expires in minutes — run /web again anytime. |
cmd | type it in any chat (web or a Telegram/Slack DM) → a ready-to-paste npx github:NTBooks/Fanad <server> <token>
command for the terminal client (a full-screen chat in your console). It runs in any terminal with Node.js 24+; npx fetches the client from the repo, so no checkout is needed. Admin opt-in: the owner enables it under
Settings → Security → Terminal client tokens. The token is shown once; choose how long it stays valid (30 / 90 days, 1 year, or never) when you mint it, and revoke anytime in the same place. |
token | type it in any chat → a warning + yes/no, then a read-only, never-expiring token scoped to your own account (shown once). It's the credential a Home Assistant dashboard needs: it can only read /api/ha/summary, never post or change anything. Any authorized user can self-mint; same enable switch as cmd. Copy it, then delete the message. |
Everything on this sheet works in the web chat too, plus GUI views the phone can’t do:
kanban board for tasks, notes wall, metric charts, lists outliner, templates,
diet report with inline food-log edits, the 📔 journal, and 🧪 batches — toggle GUI/Text per view, pick a theme,
and manage your modules in Settings.
On a wide screen the web chat also floats side panels in the empty space beside the
column: a shortcut legend on the left (tap a letter to start that command) and a status panel on the
right — your module toggles, the task you’re working on, upcoming timers & reminders, and today’s notebook /
mood / date. Both follow your module opt-ins, and one » button hides the whole layer at once.