# Using the app: gestures, tabs, panes and key bar

> Learn the Muxr app: touch gestures, tabs and panes, the command center, the key bar, fullscreen modes, tablet layout and settings.

Source: https://muxr.app/guide.html

# Usage Guide

How to drive Muxr: gestures, command center, keyboard bar, fullscreen modes, tablet layout, and settings.

## The four screens

- **Connect** — authenticate with credentials or a QR code.
- **Sessions** — list, create, rename, and kill sessions. On a herdr backend this is the single herdr session, whose workspaces appear as switchable spaces in the Terminal screen.
- **Terminal** — the live terminal with tab bar, pane strip, and command center.
- **Settings** — manage tokens, saved servers, appearance, and preferences.

## Connecting

- **Manual** — type the server URL and paste a bearer token.
- **QR scan** — tap the FAB and scan a code generated by `muxrctl`.
- **Saved-server pill** — tap a pill to pre-fill its credentials; a biometric prompt unlocks a protected token.

Follow the steps in [pairing](https://muxr.app/docs.html#pair). **Remember for 4 weeks** keeps the saved login for four weeks.

![The Connect screen: server URL, login token, Remember for 4 weeks, trust mode, connect button, a saved server and the QR scan button](https://muxr.app/assets/img/screenshots/connect.webp)

Connect screen

## Sessions

- **Tap a session card** — opens it in the Terminal screen.
- **Long-press a session card** — rename or kill it; killing asks for confirmation.
- **New session** — tap the dashed “+ new session” button (the create button on tablet) and enter a name.

![The Sessions screen: zellij and herdr session cards showing pane and tab counts, and the new-session button](https://muxr.app/assets/img/screenshots/sessions.webp)

Sessions screen

## Terminal gestures

| Gesture | Target | Effect |
|---|---|---|
| Tap | An **unfocused** pane | Focus that pane (sends a `FocusPane` RPC) |
| Tap | The **focused** pane | Opens the soft keyboard for input |
| Double-tap | Any pane | Toggles server-side pane fullscreen (`TogglePaneFullscreen` RPC) |
| Long-press | Terminal text | Starts text selection — see [Copy text](https://muxr.app/guide.html#copy-text) below |
| Back gesture | — | Exits client-side immersive mode first; if not immersive, prompts to detach from the session |

### Copy text

Long-press text to select the word under your finger, then drag to extend the selection word by word. A **magnifier loupe** floats above your finger while selecting. Release to show a floating **Copy** chip; tap it to copy to the system clipboard, or tap elsewhere to dismiss.

Selection reads the rendered terminal buffer on the client, so it works on every backend.

![A pane split showing a shell above htop, running in the Terminal screen](https://muxr.app/assets/img/screenshots/terminal-htop.webp)

a pane split: a shell above htop

## The command center

Manage tabs and panes here. On phone, tap the FAB in the lower corner to open a bottom sheet. On tablet, a persistent 220 px left pane rail is always visible.

- **Tab pills** — tap to switch tabs (`GoToTab` RPC).
- **+ tab** — adds a tab.
- **Pane rows** — tap to focus a pane.
- **New pane card** — tap for a tiled pane; long-press for a floating pane.
- **Long-press a tab or pane row** — rename or close it.

![The panes and tabs sheet: three tabs, the shell tab expanded to its two panes](https://muxr.app/assets/img/screenshots/panes-tabs.webp)

the panes & tabs sheet: three tabs, the shell tab expanded to its two panes

## Keyboard bar

| Key | Sequence sent | Notes |
|---|---|---|
| `Ctrl` | — | One-shot latch: applies to the next key — bar or soft keyboard — then clears |
| `Alt` | — | One-shot latch: applies to the next key — bar or soft keyboard — then clears |
| `Esc` | `\x1b` | Escape character |
| `Tab` | `\t` | Horizontal tab |
| `↑` | `\x1b[A` | Cursor up |
| `↓` | `\x1b[B` | Cursor down |
| `→` | `\x1b[C` | Cursor right (forward) |
| `←` | `\x1b[D` | Cursor left (back) |
| `PgUp` | `\x1b[5~` | Page up |
| `PgDn` | `\x1b[6~` | Page down |
| `Del` | `\x1b[3~` | Forward delete |

## Fullscreen vs immersive

### Server-side pane fullscreen

The zellij RPC `TogglePaneFullscreen` expands one tiled pane to fill its tab on the server, so other connected clients see it too. **Double-tap** a pane to trigger it. See [Read-only mode](https://muxr.app/guide.html#read-only-mode).

### Client-side immersive mode

Hides the OS navigation bar and the app's chrome on the client only. The **back gesture** exits it before any detach prompt.

## Tablet differences

Tablet layout starts at the **840 dp** breakpoint:

- The pane rail replaces the phone's FAB and bottom sheet, and collapses to a **56 px icon mini-rail** in immersive mode.
- **Connect** uses two columns.
- **Sessions** and **Settings** use master-detail layouts.

## Settings

- **Connection info** — server endpoint, TLS trust label, and server/backend versions.
- **Tokens** — create and revoke auth tokens on the server.
- **Saved servers** — manage saved profiles and their biometric-protected credentials.
- **Muxr Pro** — shows your plan (Free or Pro) and opens the upgrade.
- **Appearance** — font family (downloadable from the server's font catalog), font size, cursor style, and the mac-option-as-meta toggle for Option key behavior on iOS/macOS.
- **Bell notification** — toggle terminal bell notifications.
- **In-app log viewer** — read the talker log stream for diagnostics.
- **Disconnect** — detach and return to the Connect screen.

![Server settings: connection, auth tokens, saved servers, Muxr Pro, terminal appearance](https://muxr.app/assets/img/screenshots/settings.webp)

server settings: connection, auth tokens, saved servers, Muxr Pro, terminal appearance

## Read-only mode

> **Read-only token**
>
> With a read-only token, the **keyboard bar is disabled** and nothing is sent to the server. All create, rename, close, and server-side pane fullscreen affordances are hidden. Client-side immersive mode and **text selection and copy** remain available.
