Jeeter is installed — now how do you use it? This guide covers initial setup, commissioning a Matter device, and all app features.
Not installed yet? Start with the Jeeter installation guide.
Interface at a glance
The app is organized into 5 tabs in the bottom bar:
| Tab | Icon | Purpose |
|---|---|---|
| Jeedom | Home | List of Matter devices in your Jeedom |
| Devices | Devices | Devices detected / commissioned by Jeeter |
| BLE | Bluetooth | BLE proxy — scan, connect, commissioning |
| Info | Info | Matter server status, OTBR/Thread |
| Settings | Gear | IP, ports, API key, notifications |
The top bar shows the app name and WebSocket connection status (animated dot).
Step 1 — Configure Jeedom access
Settings tab → Internal address
Enter your Jeedom's local network settings:
| Field | Value |
|---|---|
| Local IP | Your Jeedom's IP (e.g. 192.168.1.100) |
| BLE port | WebSocket BLE proxy port (default 5580) |
| Jeedom HTTP port | Jeedom interface port (default 80) |
| Matter plugin API key | Plugins → Matter → Configuration → API Key |
The API key is required for the Jeedom tab and commissioning. Without it, devices won't appear.
Tap Save — settings are persisted between sessions.
Remote access (optional)
The External address section lets you use the Jeedom tab outside your local network (mobile data, other Wi-Fi):
- Enter the external IP or domain (e.g. via Tailscale:
100.x.x.x) - Choose
httporhttpsprotocol and the corresponding port
For secure remote access without public exposure, Tailscale is the ideal solution. Your Jeedom's Tailscale address goes directly in the "IP / external domain" field.
BLE always uses the internal address — the WebSocket proxy must be on the local network.
Step 2 — Check Matter devices
The Jeedom tab shows all active Matter devices reported by the plugin.
Each card shows:
- Device name
- Manufacturer and firmware version if available
- Online (blue) or Offline (red) status
- Matter node number
The summary at the top shows the count of online, offline, and total devices.
Tap Refresh to manually reload the list.
Step 3 — Commission a Matter device
Commissioning is done from the BLE tab.
3.1 — Scan the device QR code
Tap the QR code icon in the central card:
- The camera opens in scan mode
- Point it at the Matter QR code printed on the device or in its manual
Once scanned, Jeeter displays the extracted QR code information:
- Discriminator — unique BLE device identifier
- Setup PIN — pairing code (masked — tap to reveal or copy)
- Transports — supported BLE / Wi-Fi / Thread
- Vendor — device manufacturer
No accessible QR code? Enter the code manually in the text field, then press Enter.