Usage

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. 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
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
Sessions screen

Terminal gestures

GestureTargetEffect
TapAn unfocused paneFocus that pane (sends a FocusPane RPC)
TapThe focused paneOpens the soft keyboard for input
Double-tapAny paneToggles server-side pane fullscreen (TogglePaneFullscreen RPC)
Long-pressTerminal textStarts text selection — see 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
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
the panes & tabs sheet: three tabs, the shell tab expanded to its two panes

Keyboard bar

KeySequence sentNotes
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\x1bEscape character
Tab\tHorizontal tab
↑\x1b[ACursor up
↓\x1b[BCursor down
→\x1b[CCursor right (forward)
←\x1b[DCursor 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.

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
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.