---
description: >-
  During development, it can be useful to emulate the Mark II display on your
  primary machine.
---

# Mycroft-GUI on a PC

## Installation

The [Mycroft-GUI](https://github.com/mycroftAI/mycroft-gui) package requires some newer packages, so a newer distribution such as KDE Neon or K/Ubuntu 20.04 is recommended.&#x20;

On supported systems, the installation is equivalent to a development installation of mycroft-core:

```bash
git clone https://github.com/mycroftAI/mycroft-gui
cd mycroft-gui
./dev_setup.sh
```

{% hint style="info" %}
For more detail see the [Getting Started](https://github.com/mycroftAI/mycroft-gui#getting-started) section of the mycroft-gui repository
{% endhint %}

## Running the application

Running the Mycroft GUI is as simple as launching:

```bash
mycroft-gui-app
```

If mycroft-core is not already running, all Mycroft services will be started.

By default the GUI window includes a text entry box to send utterances to Mycroft.

![Mycroft-GUI application](https://3704056704-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LocrEaSe-b3SJ4H87SC%2F-Mea_QywPLd563pv_h1o%2F-Mec4npOVWRBBF_rdw9S%2Fmycroft-gui-screenshot.jpg?alt=media\&token=05259711-8c82-421d-bcac-b906023d9263)

In the bottom-left corner of the window is a hamburger-style menu. Here you can find hints for using Mycroft, settings for the mycroft-gui application, and licensing information.

### Emulating a Mark II

In order to emulate the display of a Mycroft Mark II, or any other device, you can set the dimensions of the screen and hide the text input bar when launching the application.

```bash
mycroft-gui-app --width=800 --height=480 --hideTextInput
```
