Usage

Usage

Launch

Start the compiled binary:

./bin/superterm

Each visible pane contains a real local or remote terminal process. The application starts with the configured default template/session/window when one is defined.

The screenshot illustrates the pane layout, window borders, status line, and independent PTY-backed shells in one workspace.

Controls

Key	Action
F2	Vertical split, side by side
F3	Horizontal split, stacked
Alt-F3	Close the focused pane; exit when one remains
F6 / F7	Next / previous pane
F5	Maximize or restore the focused window
Ctrl-F5	Move or resize the focused window
Alt-F9	Minimize the focused window
Alt-F4	Close the focused window
+ / -	Increase or decrease pane width
* / /	Increase or decrease pane height
Ctrl-S	Save the current session or template selection
Alt-X	Exit and save when autosave is enabled
Alt-Q	Exit without saving

The same actions are available from the Panels, Size, Templates, Windows, Sessions, Terminals, Session, and Help menus.

Resize Behavior

The parent terminal emulator controls the pixel size of the window. superterm reads the terminal's current rows and columns, updates the FreeVision surface, relayouts every pane, resizes each virtual screen, and sends TIOCSWINSZ to each child PTY. A periodic size check also catches resize changes that are not delivered as a direct application event.

This means a screenshot should be taken after the terminal window has settled. Do not maximize the terminal solely to capture the application; a normal window geometry shows the same adaptive layout more clearly.

Session Wizard

Open Session -> New session wizard. In Spanish mode use Sesion -> Asistente nueva sesion.

For each of one to four panes, enter a connection command and an optional command to run after it starts:

Connection command: ssh -tt alice@prod.example.com
After connecting:   tmux new-session -A -s alice-prod

The wizard is intended for quick workspaces. It does not edit INI or SQLite templates and does not store credentials. Use a named template for a workspace that must be reproducible across restarts.

The wizard collects all pane entries before replacing the current runtime. If you cancel it, the existing panes remain unchanged. Commands run under the configured login shell and are intentionally not parsed or validated.

Templates, Sessions, and Windows

Templates are named profiles. Each template contains sessions, each session contains windows, and each window contains one or more terminal panes.

Use the Templates, Sessions, and Windows menus to switch the active runtime. Switching recreates the selected template's PTYs. The default template, session, and window can be selected in user configuration.

Language

The default interface is English. Select Language or Idioma to switch between English and Spanish. The choice is saved in the user configuration.

Saving and Restoring

User session state is stored in ~/.superterm/session.ini. Alt-X exits with autosave enabled, while Alt-Q exits without saving. Configure autorestore=1 when the saved session should be restored on startup.