# olef emulator

Source: https://olef.dev/docs/reference/cli/emulator

Generated from **Olef 3.0.2**. [All commands](https://olef.dev/docs/reference/commands) · [Capabilities and requirements](https://olef.dev/docs/reference/capabilities)

These entries describe available commands, not a sequence to run. Check prerequisites before changing app, device, or cloud state. Global options are listed in the [command catalog](https://olef.dev/docs/reference/commands#global-options).

## olef emulator

List, boot and shut down Android emulators (AVDs)

```bash
olef emulator --help
```

Output: **json**.

### olef emulator list

List the AVDs on this machine, and which are running (as which serial)

```bash
olef emulator list --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef emulator boot

Boot an AVD and wait until it has finished starting (returns at once when it's already running)

```bash
olef emulator boot --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `<avd>` | **Required.** AVD name, as `emulator list` shows it |
| `--no-window` | Run without the emulator's own window (watch it with `olef pane`) |
| `--cold` | Cold boot: ignore the saved snapshot |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef emulator kill

Shut down a running emulator

```bash
olef emulator kill --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `<avd>` | **Required.** AVD name or adb serial (`emulator-5554`) |
| `--json` | Accepted for compatibility; output is always JSON. |