Widgets & Live Activities
Home Screen and desktop widgets, Live Activities with the Dynamic Island, and the macOS Dock menu.
Widgets
SwiftServer ships two widgets:
- SwiftServer Overview (small) — total, online, and offline server counts at a glance.
- SwiftServer Machine (medium) — one machine's snapshot: status and latency, cores, memory, storage, uptime, and CPU / RAM / network / disk gauges. Each machine widget is configurable — long-press it and choose the machine.
To add one on iPhone or iPad: touch and hold an empty area of the Home Screen, tap +, search for SwiftServer, and pick a widget. On the Mac: open Notification Center, click Edit Widgets, and search for SwiftServer.
Machines must have dashboard status enabled to be offered in the machine widget — manage the list in Settings → Widgets & Live Activities.
How fresh is a widget?
Widgets are system snapshots, not live views. While SwiftServer is open, it writes fresh snapshots and asks the system to reload widgets. When the app is closed, iOS and macOS may wake SwiftServer briefly in the background, but the system decides when that happens and may delay or skip it — open the app for the freshest status. Widgets tap straight into the app as a fast entry point.
Live Activities & the Dynamic Island
On iPhone, when a terminal, SFTP, or port forwarding session is running and you leave the app, a Live Activity appears on the Lock Screen and in the Dynamic Island: session count, machine, elapsed time, and a chip per session type. Tap it to jump back to your sessions.
Control this with Show Live Activities in Settings → Widgets & Live Activities (on by default).
On the Mac
The Dock menu lists your recent connections — right-click the SwiftServer
icon and jump straight into a machine. The menu bar carries the usual
commands with shortcuts: New Machine (⌘N), Global View,
Refresh All (⌘R), and Refresh Failed Only (⇧⌘R).