> For the complete documentation index, see [llms.txt](https://mycroft-ai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mycroft-ai.gitbook.io/docs/skill-development/displaying-information/mycroft-gui-on-a-pc.md).

# 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. 

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](/files/-Mec4npOVWRBBF_rdw9S)

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
```