> For the complete documentation index, see [llms.txt](https://docs.kouch.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kouch.dev/emulators/emulators/downloads.md).

# Downloads

The download queue where emulator installs and updates run, one at a time.

Emulator installs and updates run in **one queue**, one at a time. Open it from **Start › Downloads**, from the download indicator in the top bar while something is downloading, or from the **Downloading** row on Home.

Each download shows its name and where it's up to:

1. **Queued:** waiting for the one before it.
2. **Checking source…:** finding the right file in the emulator's official releases.
3. **Downloading:** with a progress bar.
4. **Verifying checksum…:** making sure the file is exactly the one the source published. A file that doesn't match is refused.
5. **Unpacking…**
6. **Installed**, with the version. Or **Failed**, with the reason.

Press **A** on **Dismiss** to clear a finished or failed download from the list.

When nothing's downloading, the screen says **Nothing is downloading. Emulator installs and updates show up here.**

{% hint style="info" %}
Kouch downloads **emulators only**, from the source named in their profile. It never downloads games, BIOS, firmware or keys.
{% endhint %}

## If a download fails

The profile stays imported. Once the problem is fixed (you're back online, say), go to **Settings › Emulators**, open the emulator's **Versions & updates** and install the version again.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.kouch.dev/emulators/emulators/downloads.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
