> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/get-started/installation-and-first-startup.md).

# Installation & First Startup

Get started !

## Installation

* Download the latest Retrobat Setup on the [Retrobat Website](https://www.retrobat.org/download/).
* Run the Setup program and click **Next**

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FrGyQVLLHx7L44CEgBDLh%2Fimage.png?alt=media&amp;token=038a95be-96a2-42dd-974b-12509aa95b10" alt=""><figcaption><p>I Agree</p></figcaption></figure></div>

* Read the licence agreement and accept it, click **Next**

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fo2dvl0EDTWtQOWUSK5Dl%2Fimage.png?alt=media&amp;token=6c699c82-9c1c-4e4d-a05b-428a3f6dca14" alt=""><figcaption></figcaption></figure></div>

* Select the prerequisites to install and click **Next**

{% hint style="info" %}
RetroBat will detect if the prerequisites are already installed, this page might not appear.
{% endhint %}

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FPKiydPw0iDQZByBg6gHK%2Fimage.png?alt=media&amp;token=24bee735-42ab-4f0f-a61c-9c2ba949f98a" alt=""><figcaption></figcaption></figure></div>

* Browse to the destination folder and select **Install**.

{% hint style="danger" %}
Attention: an installation folder that is too long (or with too many subfolders) can cause issues with some emulators like libretro:mame.

Also: do not use a folder with special characters (accents, ...).

As well as: do not put RetroBat directly at the root of a drive (e.g. D:\RetroBat.exe): always add a subfolder.

Finally: avoid folder names which include spaces.
{% endhint %}

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fl6Z2nBEVqeRMaE3caKlC%2Fimage.png?alt=media&amp;token=8fd7cec8-edc0-48ef-a507-9a41802ed800" alt=""><figcaption><p>Select installation folder</p></figcaption></figure></div>

* Wait until the Installation completes, then click **Finish**

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FaGxYKBxQvpdcCbFbBqdC%2Fimage.png?alt=media&amp;token=a73e4d18-70db-4199-808a-f732d7cfcf38" alt=""><figcaption></figcaption></figure></div>

The RetroBat folder structure looks like this:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FHiQQ98RNr8R5WpFm66gI%2Fimage.png?alt=media&amp;token=82ad0abe-0512-4e01-b50c-09c9cf773c84" alt=""><figcaption></figcaption></figure></div>

## First startup

Double-click `RetroBat.exe` file in your RetroBat folder or use the desktop shortcut.

After the video splash screen, the **System View** is shown.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fss9oS61pdQEZvW0n6qgs%2Fimage.png?alt=media&amp;token=c7b0d481-57a8-437a-86a4-7d0f2e4e3c65" alt=""><figcaption><p>System View</p></figcaption></figure></div>

{% hint style="info" %}
The language may vary, RetroBat detects your OS language at first start-up.

The following list of languages are recognized : english, french, japanese, spanish, german, italian, dutch, portugese, russian, korean, chinese, polish, arab.
{% endhint %}

On this view, you can navigate with the keyboard or with a game controller. If your controller is not automatically configured by RetroBat:

* Press any button and the **CONFIGURE INPUT** screen appears.

<div align="left"><figure><img src="https://i.imgur.com/C8T3fn5.png" alt=""><figcaption><p>CONFIGURE INPUT screen</p></figcaption></figure></div>

* Press and hold any button to enter the **CONFIGURING** screen.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F0e8Z41YMK4l6mtGNorjL%2Fimage.png?alt=media&amp;token=b2fa50e1-254e-4086-acc6-2db0bdbdac53" alt=""><figcaption></figcaption></figure></div>

* Define all the keys based on your controller layout.&#x20;

{% hint style="info" %}
We recommend to use **SELECT** (or Back) as hotkey.
{% endhint %}

CONGRATULATIONS: You have installed RetroBat and launched it for the first time successfully.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/get-started/installation-and-first-startup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
