Booting your OpenVoiceOS device.

Depending on which image you downloaded you will first see the boot splash which indicates the Operating System is booting. For the buildroot edition the below boot splash will be shown.

If this is the very first time you boot your device, booting might take a bit longer as normal as the system is preparing its local filesystem and extending it over the full size of the sdcard/USB device. Eventually the progress bar will be filled up indicating the Operating System has been fully booted, after which the ovos-shell animated loading screen will be shown.

Again, if this is the first time you boot your device this might take a bit longer as the ovos-core configuration is populated and skills are being setup.

Setting up your Wi-Fi network connection

Depending on which image you downloaded you will be greeted by the network configuration screen with either one or two option. The buildroot image supports setting up the network via two options.

  • On a mobile device
  • On the OpenVoiceOS device itself.

You can also skip this step to configure it later or never ask it again if you want your device to run fully offline. (Bear in mind you need to configure your device to use local STT and TTS engines and obvious asking your device things that require internet will not work.)

On Mobile Setup

Choosing this option will create a temporarily open network - hotspot called "OVOS" to which you can connect from your mobile device.

On your mobile device go into Settings -> Wi-Fi Settings and the "OVOS" open network will appear in its list.

Connect your device with the OVOS network and a webpage will open to configure the Wi-Fi network on your OpenVoiceOS device. (NOTE: On newer mobile operating systems the captive portal capture has changed and the website will not automatically be opened. If this is the case you can open a browser manually and go to ) The following webpage will be shown;

Select your Wi-Fi network from the list, insert your password and press the "Connect" button.

If everything went fine, you will soon see the green "connected" screen on your OpenVoiceOS device.

On Device Setup

Choosing this option allows you to set up your Wi-Fi network straight on your OpenVoiceOS device. If selected a screen with the available networks will be shown on your OpenVoiceOS device.

Select your network from the list and tap / click on it to allow you to insert your password. If you have a touch screen an on-screen keyboard will appear when you tap the password field. If not use a keyboard.

When you have inserted your password, click / tap the connect button and after a short connecting animation, if all went fine you will see the green "connected" screen on your OpenVoiceOS device.

(Re)configure your network from the drop-down menu

If you have skipped the Wi-Fi network setup before, or you just want to reconfigure your network. On the homescreen of your OpenVoiceOS device swipe down the top menu and click the "Wi-Fi" icon. This brings you to the same on-device configuration screen.

From here you can select another network or click the configuration icon on the right of connected network for details or to remove it from the configured networks.

Selecting Your Backend

What is a backend ?

Mycroft A.I. - Selene Backend

NOTE The Public Selene Backend from Mycroft may be going away soon, it's not recommended to use.

The Pairing Process


The GUI will now show you a Pairing Code, This pairing code needs to be entered on the mycroft backend which you can find online at

  • Create an account using your email id on
  • Head over to
  • Enter the pairing code, a unique device name, and location settings
  • Click next on the web interface, your device should now be paired

No backend - No calling home

Select A Text To Speech (TTS) Engine: A text-to-speech (TTS) system converts normal language text into speech, select an engine from the list


Select A Speech To Text (STT) Engine: A speech-to-text (STT) system converts human speech to text, select an engine from the list


Personal backend - Host your own

Personal Backend

Personal backend is a reverse engineered alternative to selene and requires the backend to be hosted locally.

  • Install and Configure your personal backend, information available on:
  • The gui on device will display a setup page to enter the host address of your hosted backend on your device
  • Pairing with your personal backend happens automatically once you hit the confirm button with the correct host address