# xterm Emulation (OSC 9 ; 10)

> Turn ConEmu's xterm emulation on or off.

- **Sequence:** `OSC 9 ; 10 ; n ST`
- **ECMA-48:** [§8.3.89 OSC – Operating System Command, p. 51](https://archive.org/details/ecma-48-5th-edition-june-1991/page/n64/mode/1up)
- **Specification:** [ConEmu specific OSC, ConEmu's ANSI escape codes](https://conemu.github.io/en/AnsiEscapeCodes.html#ConEmu_specific_OSC)

`OSC 9 ; 10 ; n ST` turns ConEmu's xterm keyboard and output emulation off,
`0`, or on, `1`, or its output emulation alone off, `2`, or on, `3`.
`OSC 9 ; 10 ST`, with no `n`, asks for it.

It is one of the commands ConEmu, a Windows terminal, put under `OSC 9`; the
[progress report](https://control-codes.page/osc/progress/index.html.md) page lists them all, and their definition
is the [ConEmu specific OSC](https://conemu.github.io/en/AnsiEscapeCodes.html#ConEmu_specific_OSC) table in ConEmu's documentation.
iTerm2 uses `OSC 9 ; text ST` for a [notification](https://control-codes.page/osc/notify/index.html.md), and a
terminal that has both tells them apart by what follows the `9`.

A default xterm ignores all of `OSC 9`, which is not among [the OSC numbers it knows](https://github.com/ThomasDickey/xterm-snapshots/blob/xterm-411a/misc.c#L3476-L3504). libghostty-vt recognizes it and does nothing with it, so neither shows
anything.

## Validation

### CONEMU10-1: Nothing happens

Input, one step per line:

```text
A
\e]9;10;1\a
\e]9;10\a
B
```

Expected screen:

```text
|AB____|
cursor 1,3
reply none
```

---

This is the Markdown version of <https://control-codes.page/osc/conemu-xterm/>. On that page every validation case runs live in libghostty-vt, the terminal emulation core of Ghostty, compiled to WebAssembly.

The validation cases are written in the notation described in <https://control-codes.page/notation/index.html.md>.