Pairing Your Device
Pairing makes information available to your Device to personalise your experience, such as which units of measurement you prefer, and your general location.
Last updated
Was this helpful?
Pairing makes information available to your Device to personalise your experience, such as which units of measurement you prefer, and your general location.
Last updated
Was this helpful?
Each of your Mycroft Device(s) must be Paired with your account. If you already have a Mycroft account, you can start pairing a new device by visiting:
Pairing makes information available to your Device to personalise your experience, such as which units of measurement you prefer, and your general location.
Pairing is also used for services that require API authentication, such as
Wolfram Alpha
Google Speech to Text
Weather Skill API and OpenWeather
You can by using
Your Facebook account or;
Your Google account or;
Your GitHub account or;
By signing up with your email address and choosing a password
By default, Mycroft will not store your usage data or keep any recordings of your voice.
When creating an account, you will be asked if you would like to Opt-In to the Open Dataset. If you choose to Opt-In then Mycroft will record your voice when Speaking the Wake Word and Utterances. This data is de-identified and used anonymously to train Mycroft to better recognize the Wake Word and Utterances. It will also be provided to key partners such as Mozilla, to assist in the development of speech recognition tools such as .
If you change your mind at any time, you can change your selection under the Agreements section of .
To add a Device to your home.mycroft.ai account, you will need a 6-character Registration Code. The Registration Code is provided in different ways depending on which Device you have.
After your device has connected to the internet, Mycroft will speak a unique six character code. For the Registration Code CKAMP7, Mycroft would say:
Your pairing code will be different.
After you have connected your Mark 1 to Wifi, Mycroft will speak a 6-character Registration Code. This code will also appear on Mycroft's LED screen.
After you have connected your Picroft to Wifi, Mycroft will speak a 6-character Registration Code.
After your Mycroft for Linux installation is successfully installed, Mycroft will speak a 6-character Registration Code.
Once complete, click 'NEXT' to pair the Device. Wait a few seconds, and then you'll be taken to a new screen confirming your Pairing has been successfully completed.
Congratulations! Your Mycroft Device is now paired, and is ready to start accepting your commands.
Once you have paired your Mycroft Device, pairing information is stored in:
~/.mycroft/identity/identity2.json
DO NOT SHARE THIS INFORMATION WITH OTHERS - IT IS YOUR MYCROFT IDENTITY
You may be asked for this information by Mycroft support staff while troubleshooting Device and/or Pairing issues.
From the User menu in the top right, choose 'Devices'.
This is list of all Mycroft devices paired with your account. From here you can add a new device, or change settings for existing devices.
Settings available:
Name - a unique name for your device.
Placement - location of your device e.g. Kitchen, Bedroom or Office. This is in place for location based utterances such as "turn off the light" which should only turn off lights in the current location, not all lights connected to your account.
Geographical Location - your devices approximate geographical location, used for queries such as the local weather and time.
Voice - By default, Mycroft will use the American Male
voice, however you are free to choose other voices.
These allow you to choose your preferred:
Units of measurement
(NOTE: choosing Miles instead of Kilometers will also switch your temperature format to Fahrenheit instead of Celsius)
Time format
Date format
All your Mycroft devices will use this information to tailor your experience.
The Device Default settings define your base configuration and will be used for any new device being added to your account. These may then be modified for each device.
If you're stuck connecting to Wifi, please read the .
If you're stuck connecting to Wifi, please read the .
Once you have your Registration Code, you can then go to
Use your Pairing Code, and provide a meaningful name and location for the Device. This will help you in the future if you have multiple devices. All other options will be pre-filled from your , but can be changed for each individual device.
Wake Word - By default, Mycroft will listen for "Hey Mycroft" to activate. A number of other pre-trained Wake Words are available. Additional configuration options are available through or by training your own Wake Word model.
Advanced users may configure additional options using an on-device configuration file. This includes setting an alternative speech-to-text engine, text-to-speech engine, or wake word listener. See the for more detail.