Your smart-home pairing code vault for Home Assistant
GitHub · rematters.casa · Viewer
Rematters (Remembers + smart-home protocols) helps you store, organize, and retrieve pairing codes you would otherwise lose in email, boxes, or controller apps. Use it entirely on Home Assistant, sync with Rematters Cloud, or combine both.
| Resource | Link |
|---|---|
| Product site & cloud vault | rematters.casa |
| Read-only export viewer | viewer.rematters.casa · Rematters-Webviewer |
| Docker (self-host, no HA) | Rematters-Docker |
| Cloud app source | Rematters-Web |
- Vault: categories (room, vendor, project) with colored icons; each entry has a name, notes, and protocol-specific fields.
- QR & labels: generate QR PNGs and printable sticker cards (Matter layout, HomeKit official card SVG, Z-Wave SmartStart label).
- Scan: camera or image upload to add codes; duplicate detection per protocol.
- Home Assistant link: optional
entity_id+ attribute; Pull from HA copies the value into the vault. - Export / import: JSON backup compatible with the Rematters Viewer.
- Google Drive: scheduled automatic JSON backups (optional).
- Rematters Cloud: bidirectional sync with your account at rematters.casa (optional).
The add-on UI runs inside Home Assistant via Ingress (no extra login; HA handles access).
| Protocol | What you store | QR / card |
|---|---|---|
| Matter | MT:… payload and/or 11-digit manual code |
Matter sticker (logo + QR + manual code) |
| HomeKit | 8-digit pairing code, setup ID, category & flag; builds X-HM://… URI |
HomeKit label card (400×540 SVG, quartile QR) |
| Z-Wave SmartStart | 90-digit SmartStart string; DSK and S2 PIN derived automatically | Z-Wave label + QR (version 3, EC level L) |
Cloud sync and export use the same vault schema for all three types (code_type: matter, homekit, or zwave).
| Mode | Best for |
|---|---|
| HA add-on only (this repo) | Data stays on your Home Assistant instance |
| Rematters Cloud | Browser vault at rematters.casa; no HA required |
| Hybrid | Add-on + cloud account linked with a sync token; merge on schedule and on demand |
| Docker | Same app as the add-on, self-hosted without Supervisor — Rematters-Docker |
Hybrid sync is bidirectional: newest updated_at wins per code or category. The website does not push into HA entities; the add-on syncs vault JSON with the cloud API.
Settings → Apps → Install app → Repositories (or Add-on store → Repositories on older setups)
https://github.com/Rematters/Rematters-HA
Wait until the repository appears, then refresh if needed.
Settings → Apps → Rematters → Install → Start.
Open Web UI (Ingress panel). Optional: add Rematters to the sidebar (Show in sidebar).
Configuration tab — see Add-on options below. After changing cloud or Drive settings, Save and restart the add-on.
Requirements: Home Assistant with Apps / add-on support (Supervised, OS, or compatible). Architectures: aarch64, amd64, armhf, armv7.
Set these under Settings → Apps → Rematters → Configuration.
| Option | Default | Description |
|---|---|---|
cloud_enabled |
true |
Enable sync with Rematters Cloud |
cloud_url |
https://rematters.casa |
Cloud API base URL (use default unless self-hosting the web app) |
cloud_token |
(empty) | Personal sync token from rematters.casa → Account → Generate HA sync token (rm_…) |
With a valid token, the add-on syncs on startup and every 15 minutes. In the Ingress UI, use Cloud sync for an immediate merge.
To run without the cloud, set cloud_enabled to false and leave cloud_token empty.
| Option | Default | Description |
|---|---|---|
gdrive_enabled |
false |
Upload vault JSON backups to Google Drive |
gdrive_folder_id |
(empty) | Target folder ID (dedicated folder recommended) |
gdrive_client_id |
(empty) | OAuth 2.0 client ID (Desktop app) |
gdrive_client_secret |
(empty) | OAuth client secret |
gdrive_refresh_token |
(empty) | Refresh token with drive.file scope |
backup_interval_hours |
24 |
Hours between automatic uploads (1–168) |
backup_keep_count |
10 |
Maximum backup files kept in the folder (1–100) |
One-time Google Cloud setup (OAuth consent, Drive API, refresh token) is described in rematters/DOCS.md.
- Create a category (e.g. Living room).
- Add code → choose Matter, HomeKit, or Z-Wave.
- Enter the pairing data (paste QR text, scan, or Pull from HA).
- Open the card actions to download QR, label/card, or export the vault.
Languages: English by default; Dutch, German, French, Spanish, Italian, and Portuguese via the language menu in Ingress. Add-on configuration panel strings: rematters/translations/.
Register at rematters.casa for a browser-based vault with the same features (scan, share links, sticker export). Use it standalone or link the HA add-on:
- Create an account and generate an HA sync token.
- Paste the token into add-on Configuration →
cloud_token. - Restart the add-on.
Details: DOCS.md — Rematters Cloud (hybrid).
Download Export JSON from the add-on or cloud app. Anyone can open that file at viewer.rematters.casa without installing HA — QR codes are rendered locally in the browser.
Rematters-HA/ ← HA Apps repository root
├── repository.yaml
└── rematters/ ← add-on (slug: rematters)
├── config.yaml ← version, options, schema
├── icon.png / logo.png
├── DOCS.md ← OAuth, JSON schema, API
├── CHANGELOG.md
└── app/ ← FastAPI app (copied to /app in container)
- DOCS.md — usage, Google Drive OAuth, vault JSON schema, Ingress API
- CHANGELOG.md — release history
cd rematters/app
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
REMATTERS_DATA=/tmp/rematters-data python main.pyOpen http://127.0.0.1:8099 (no Ingress; API is open locally).
- HomeKit QR/card layout inspired by SimonGolms/homekit-code (MIT).
- Z-Wave SmartStart QR format aligned with SDS13937 / zwave-js conventions.
MIT © Rematters