MicroRemoteHow MicroRemote works
Instructions for customers setting up a device, and for admins creating products.
For customers — set up your device
You just need the box, your phone, and your home WiFi.
1. Get the app
Install the MicroRemote app on your phone (Android). Open it and create an account with your email — you sign in with a code we email you, so there is no password to remember.
2. Add your device
On the Things screen tap the QR icon (top right), or go to Settings → Add device. Scan the QR code printed on the box or in the manual. If the camera will not scan, tap "Add by code" and type the claim code printed under the QR.
3. Connect it to WiFi
The first time, follow the in-app prompt to send your home WiFi name and password to the device. Use a 2.4 GHz network — most smart devices do not support 5 GHz.
4. Name it and control
Give the device a name (e.g. "Living room TV"). It now appears as a colored tile. Tap it to open the remote and control it. You can also use voice ("turn on the TV") from the microphone icon.
5. Optional — Google Home
To use "Hey Google", link your account in the Google Home app (search for MicroRemote under device setup). Your devices then appear in Google Home automatically.
If something goes wrong
- Device offline? Check it has power and your WiFi is working, then reopen the app.
- QR will not scan? Use "Add by code" and type the code by hand.
- Not appearing in Google Home? Say "Hey Google, sync my devices", or unlink and re-link.
For admins — create a product
This is how you turn a flashed ESP8266 into a product a customer can claim.
1. (Optional) Create a control category
Go to Controls and define a category (the set of buttons for a device kind). You can bake this into the product so the right remote appears automatically.
2. Create the product
Go to Products → fill in a name, pick the device type, optionally pick a control category, and generate. The system creates a unique serial, a firmware DEVICE_TOKEN, and a claim code automatically.
3. Flash the firmware
Copy the DEVICE_TOKEN and flash it into the ESP8266 firmware. Keep the token secret — it is how the device authenticates to the server.
4. Print the QR
Print the product QR and the claim code beneath it. Put them on the box or in the manual. The customer scans the QR to claim the device to their account.
5. Device types
Supported types include TV, AC (Gree/Coolix), Light, Relay/Plug, Fan, Lock, Speaker, Camera, Sensor, Curtain, Heater, Garage, and Universal. Pick the one that matches the hardware so the correct controller shows.
Note: you cannot import devices already in someone's Google Home — Google provides no API for that. This system exposes your devices to Google, not the other way around.
Still stuck? Contact support and include your device serial (shown in the app under Settings).