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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mycroft-ai.gitbook.io/docs/skill-development/displaying-information/mycroft-gui-on-a-pc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.