Support
Common answers first. If yours isn't here, open Maestro on your iPhone or Android phone and go to Settings > Support, or write to us at the bottom of this page.
Getting started
Install and connect
Install Maestro on your iPhone from the App Store. The Apple Watch app comes with it. If it doesn't appear on the watch, add it from the Watch app. On the iPhone, choose Use Apple Home or Connect Home Assistant. No home yet? Try the demo.
The Android app is in testing on Google Play and not yet available to everyone. It works with Home Assistant. Apple Home is only on iPhone and Apple Watch. See Android below.
Home Assistant: sign in with an administrator account. Home Assistant only lets administrators list areas and devices. Devices without an Area are listed under Unassigned. If Home Assistant's address changes later, use Change address in Settings. Your charms stay.
iPhone, Apple Watch, or both
Each one works on its own. A phone in your hand and a watch on your wrist point differently, so each learns its own pointing directions. Teach a device on the one you'll use it from. The two share what they learn about rooms and back each other up.
An Android phone works on its own, with its own charms. It does not share with an iPhone or an Apple Watch.
Teaching a device
Maestro calls this a charm. It learns where a device is from the way you point at it, so charm each device from a spot where you would actually use it. Charm it again from another spot you use, and it answers from there too.
On iPhone and Android
Point the top edge of the phone at the device and hold the orb. Keep the top edge on the device and sweep a little around it while the ring fills. Then pick the device from the list.
On Apple Watch
Open the charm page. Its title names the room you're in; if that's wrong, pick your room on the rooms page first. Tap a device, then sweep your arm around it while the watch counts down, taking a step or two between spots. If the watch says Too still, take two steps and keep going.
Pointing
On iPhone and Android
Point the top edge at the device. When the orb names it, tap the orb. Its controls wrap around the orb: a dial for brightness, color temperature, blind position or temperature, and buttons beside it for playback and volume. When a device has two dials, like a light's brightness and color, tap the number under the orb to switch. Anything else, like fan speed or modes, goes in a card below.
On Apple Watch
Hold your arm out toward the device, like showing it to someone. Maestro follows your forearm, not the screen. When the screen names the device, snap your fingers.
Snaps not registering? In the watch's Settings, set Trigger to Tap.
Locks and garage doors
These never open on a single gesture. Maestro asks for a second tap to confirm.
Rooms
Maestro works out which room you're in from how you point and from nearby Bluetooth signals it notes when you charm or tell it your room. It gets better as you charm more rooms. Walk between rooms normally and point when you arrive. There's no need to hold anything up while you walk.
If it guesses the wrong room, pick the right one: on a phone, tap the room name on the pointing page and choose your room; on the watch, use the rooms page. Maestro listens to that room's Bluetooth for a few seconds and learns from the correction. On a phone, if you point at a device and switch it straight back, Maestro asks Wrong room? and offers the likely rooms.
To teach every room in one walk, open the room list on Android, or the room column on a wide iPhone screen, and use Check in rooms: stand in each room and tap I'm here.
Nothing happened
When Maestro isn't sure, it declines instead of guessing, and says why: the device isn't charmed from where you stand (hold the orb to charm it from there), two devices overlap (charm one of them again from a different spot), or the room looks wrong. If a wrong device answers, choose the right one when Maestro offers it, and it learns from that too.
A new phone or watch
The iPhone and the watch each keep a backup of the other's charms. After a reinstall or on a new watch, open Apple Watch on the iPhone's pointing page and use Restore model to watch. For the iPhone's own charms, open Charmed on this iPhone and use Restore this iPhone's model. It uses the newer of the iPhone's own backup and the copy kept on the watch.
Android's backup does not copy Maestro's data, so charm your devices again on a new Android phone. Export this phone's model in Settings saves a copy you can share, for example with a support request.
Android
Nearby devices
When you start, Android asks to allow Nearby devices. That is its name for Bluetooth scanning, which Maestro uses to recognize rooms. The permission is declared as never used for location, and Maestro does not ask for your location. If you decline, pick rooms by hand, or allow it later in Android's settings for Maestro.
Home Assistant address
Enter the address you open Home Assistant with. On your home network
that is usually its IP address with port 8123, like
http://192.168.1.50:8123. Plain http works there. An https
address, such as Home Assistant Cloud or your own proxy, works if its
certificate is a trusted one. A self-signed certificate is refused.
Maestro looks for Home Assistant on your network and fills in the
address when it finds it.
Support and purchases
Open Settings from the pointing page, then Support. This phone's model is on by default and attaches a model export from the phone. Turn it off before sending if you prefer.
Maestro Unlimited on Android is a one-time purchase through Google Play. To get it back on a new phone, use Restore purchase with the same Google account. Purchases on the App Store and on Google Play are separate.
Write to us
Describe what happened and what you expected. The quickest way is from the app, in Settings > Support. It can attach a model export from your phone or watch, which helps us see what went wrong. An export includes room and device names, learned pointing directions, Bluetooth measurements and recent diagnostic events. Attachments are optional. See the privacy policy for how reports are handled.