Android guide

Sessions and tabs

Keep several SSH terminals open, move between them and come back after a dropped connection.

Warpeer is built for work that keeps running on a server while you are away. Run tmux or Herdr on the server, and Warpeer keeps you one tap away from it.

Open terminals as tabs

Each connection opens as a tab in the session dock at the bottom of the terminal. The + button in the dock opens another SSH Host or SFTP Host from your saved hosts. Swipe sideways across the terminal to move to the next or previous tab. A short label names the tab you landed on and its position, such as 1/2.

The back button in the dock returns to the app and keeps your terminals open. The menu button at the end of the dock holds Snippets, Paste, Select all, Show Keyboard, Disconnect and Close tab.

To work inside tmux, type tmux attach in the terminal as you would over any SSH client. The tmux and Herdr prefix keys described in Magic keys and snippets save you from typing the prefix by hand.

The Sessions tab

The Sessions tab shows every open terminal as a card with its host and connection state. Tap a card to continue, or the close button to end it. Below them, Connected Sessions lists hosts you used recently. Tap one to reconnect with the same saved credential.

Staying connected

While a terminal is connected, Warpeer runs as an Android foreground service and shows an ongoing notification. This keeps your connections open when you switch to another app or turn off the screen. Prevent Sleeping keeps the display on while a terminal is in front, and Keep Alive Interval sets how often Warpeer sends SSH keep-alive packets.

When a connection drops

If a live connection drops, the tab keeps its last screen and shows Connection lost with Reconnect. Your tmux or Herdr session kept running on the server, so attach it again after reconnecting.

If a new connection fails, Warpeer shows Connection Error with the endpoint, a summary, suggestions and the technical details, plus Retry and Close. See Troubleshooting.