Action Bindings and Terminal Commands

Bridging Touch Interactions to Terminal Control

While standard keyboard inputs send individual ASCII characters or keycodes, Casshper's Action Bindings allow you to trigger deep application lifecycle events, session controls, clipboard operations, and specialized Pro Admin features. Action bindings can be assigned to buttons on any Soft Key Bar or mapped to touch sequences in Custom Gestures.

Core Action Bindings

Core action bindings are built directly into Casshper and require no additional license:

Virtual Keyboard Management

• Toggle Keyboard: Instantly displays or dismisses the Android on-screen software keyboard without losing cursor focus in the active terminal session. Useful when switching between reading logs and typing commands, or when using a hardware keyboard alongside Soft Key Bars.

Session Navigation and Lifecycle

• Next Session: Switches the active terminal viewport forward to the next running background session tab.
• Previous Session: Switches the active terminal viewport backward to the previous running session tab.
• New Session: Spawns a new local Zsh shell session or prompts to connect to a bookmarked host from Saved Connections.
• Close Session: Safely terminates the active foreground session buffer after confirmation.
• Toggle Sessions Sidebar: Opens or closes the session drawer sidebar for quick access to all active background sessions and saved host profiles.

Clipboard and Buffer Operations

• Copy Selection: Copies the active highlighted text selection on the terminal canvas directly into the Android system clipboard.
• Paste Clipboard: Injects the current Android clipboard contents into the terminal input buffer in a single atomic byte stream, avoiding slow character-by-character typing.

Pro Admin Action Bindings

Pro Admin action bindings unlock advanced workflow orchestration, contextual theme switching, and dynamic toolbar swapping:

Sneaky Input Scratchpad

The Sneaky Input action opens the floating multiline text staging overlay. This allows you to compose complex commands, paste large snippets, or use Gboard swipe typing and voice dictation without terminal escape character interference or dropped keystrokes.

Detailed guide: Sneaky Input Documentation.

Theme Picker and Direct Theme Switching

Pro Admin enables on-the-fly contextual color adjustments:

• Theme Picker: Opens the in-session color theme selector modal, allowing you to switch between 450+ bundled Ghostty palettes in real time.
• Direct Theme Triggers: Assign specific theme palettes (e.g. Solarized Red for production, Tokyo Night for staging) directly to soft keys or touch gestures for instant visual isolation.

Explore server risk management in Production Server Safety and per-session styling in Contextual Themes.

Dynamic Soft-Key Bar Swapping and Cycling

When working across different tools (like Git, tmux, or Neovim), you can organize your soft keys into multiple dedicated toolbars:

• Swap Soft-Key Bar: Instantly transitions the active toolbar to a specified target bar layout (for example, switching from your Default Navigation Bar to a tmux Multiplexer Bar).
• Cycle Soft-Key Bar: Cycles forward through all your configured soft-key bars in sequence.

Learn how to configure multi-bar layouts in Multi-Soft Key Bars.

Complete Action Bindings Reference

Configuring Action Bindings

On Soft Key Bars

1. Navigate to Settings → Soft Key Bars and tap on the key button you wish to customize.
2. In the Key Editor, change the Binding Type to Action.
3. Select your target action from the dropdown list (e.g. Toggle Keyboard, Next Session, Sneaky Input, or Swap Soft-Key Bar).
4. Assign your desired button label and icon (supports UTF-8 text and symbols like ⌨, 📋, 🎨, ⇄).
5. Tap Save Key, then tap Save Settings to apply immediately.

On Touch Gestures (Pro Admin)

1. Navigate to Settings → Touch Gestures and tap + New Gesture.
2. Record your tap and swipe motion sequence on the interactive recorder.
3. Select your desired action command from the action catalog.
4. (Optional) Toggle Immediate Execution (⚡) for zero-latency execution.
5. Tap Save Gesture, then tap Save Settings.