> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socketchat.org/llms.txt
> Use this file to discover all available pages before exploring further.

# The chat screen

> Panels, keys, the mouse, Tab completion and colors.

Run `socketchat` to open the chat screen. It asks for your passphrase, then shows your rooms. It works in any terminal window of 80 by 24 characters or larger, and over SSH.

![The chat screen with three panels: Chats on the left, the open room's messages in the middle, and People on the right, above the message box.](https://mintcdn.com/socketchat/monB38keb4E2y3CS/images/chat.png?fit=max\&auto=format\&n=monB38keb4E2y3CS\&q=85\&s=3187c669d04e8bb41458b9102bf1c066)

> [!NOTE]
>
> This picture shows the classic colors. Socketchat 0.5.1 opens in the phosphor colors by default; see [Colors](#colors).

## Panels

| Panel | What it shows |
| - | - |
| **Chats** | Your rooms, marked `#`, and direct messages, marked `@`. A number shows new messages. |
| **Messages** | The open room, with times and names. The panel title is the room's name and its server, as in `Book club · chat.example.com`. |
| **People** | Everyone in the room. `✓` marks someone you verified, and `*` marks an admin. |
| **Message box** | Where you type messages and commands. The empty box reads "What's on your mind?" with the open room's name. |

The bottom line shows the keys that work right now, and the Socketchat version when the window is wide enough.

## The room's server

Each room lives on one server, and the Messages panel title names it after the room's name. The server shows as its host, with the port added when it is not 7444. In a narrow window the title drops the server and keeps the room's name. When the app has lost its connection, the title ends in "offline".

New rooms from `/new` go on the open room's server, or on the newest server you joined when no room is open. `/servers` lists every server you use and whether each is connected, and `/details` names the open room's server. See [Servers](/use/commands#servers).

## Keys

| Key | What it does |
| - | - |
| Enter | Send the message, or run the command. |
| Tab, Shift-Tab | Move between panels. While you type a command, complete it instead. |
| Ctrl-K | Open the room switcher. Type to filter, Enter to open. |
| Up, Down | Pick a room in Chats or a person in People, or scroll the messages. |
| PgUp, PgDn | Scroll the messages. |
| Esc | Close a box. |
| Y, N | Answer a question, such as whether to send a video. Only Y as the first key pressed means yes. |
| Ctrl-C | Quit. `/quit` does the same. |

## Commands and Tab completion

Type `/` to start a command, and `/help` to see them all. Tab completes a command as you type it, and Tab or Shift-Tab steps through the matches when there are several. Matching commands show on the bottom line, and a grey suggestion after the cursor shows what Tab would add; Right arrow accepts it. `/switch` and Tab complete a room's name, and `/theme` and Tab cycle the color names.

See [Commands](/use/commands) for the full list.

## Pasting

A paste goes into the message box as text, with line breaks shown as `↵`. Nothing is sent or run until you press Enter, so a pasted command never runs by itself. This needs a terminal that marks pastes (bracketed paste), which most do.

## Mouse

The mouse is on by default:

* Click a room in Chats to open it, and click a panel to move to it.
* Scroll the messages, `/help`, `/invites` and `/details` with the wheel.
* Boxes have buttons along their bottom edge, such as Yes and No. A click answers only once the box is on screen.

While the mouse is on, hold Shift as you drag to select text (Option or Fn on a Mac). To hand the mouse back to your terminal, type:

```text theme={"dark"}
/mouse off
```

`/mouse on` turns it back on, and `/mouse` says which it is. Socketchat keeps the choice in your profile.

## Colors

Socketchat has two color themes:

* **phosphor**, the default: green on a near-black screen.
* **classic**: your terminal's own background and colors.

```text theme={"dark"}
/theme classic
/theme phosphor
```

`/theme` on its own shows the colors in use. Socketchat saves the choice on your computer. To pick a theme for one run only, set `SOCKETCHAT_THEME`:

```bash theme={"dark"}
SOCKETCHAT_THEME=classic socketchat
```

Phosphor uses exact colors when your terminal reports full color support (`COLORTERM` set to `truecolor` or `24bit`), and close 256-color matches otherwise.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.