Apple Shortcuts
Shortcut recipes
Common Apple Shortcuts automations for the iPerf3 Client & Server app:
automatic Wi-Fi health checks, scheduled baselines, pre-meeting validation,
site surveys, and VPN comparison. Each recipe explains what it does and how
to build it now with the x-callback-url scheme. Downloadable
.shortcut files are on the way.
Every recipe below maps to the public
x-callback-url scheme, so you can build it today
in the Shortcuts app: add a "Open URL" step with the endpoint shown in the
API reference, then chain your own
steps around it. Prebuilt .shortcut downloads are coming; until
then the steps are fully documented and yours to adapt.
-
Auto-test on home Wi-Fi
iOS+macOSRun a 5-second iPerf3 test whenever your iPhone connects to your home Wi-Fi.
Personal automation that triggers when your device joins the SSID you configure. Runs a short Apple Shortcut against your saved iPerf3 server, stores the result, and quietly logs throughput over time. Good for spotting Wi-Fi degradation without any manual work.
When to use: Continuous Wi-Fi health monitoring
-
Daily throughput check at 9 AM
iOSScheduled iPerf3 test every weekday morning, with the result saved to Files.
Time-of-day automation that runs a longer iPerf3 test (configurable duration, default 30 seconds) against your saved server every weekday morning. Writes the result to a CSV in Files for easy review. Useful for documenting daytime throughput baselines.
When to use: Scheduled baseline measurement
-
Pre-meeting network check
iOS+macOSRun a UDP test before your Zoom or Teams meeting and alert if jitter is high.
Apple Shortcut that runs a 5-second UDP test against your saved server, reads jitter and packet loss, and shows a banner if either exceeds your thresholds (default jitter > 30 ms or loss > 1%). Pair with a Calendar trigger or run manually before joining a call.
When to use: Voice and video call readiness
-
Site survey, room by room
iOSPrompt for a room name, run an iPerf3 test, save the result tagged by location.
Manual-trigger Shortcut for Wi-Fi installers and homelab operators walking a property. Prompts for the room name, runs a 10-second TCP test, and tags the result for later filtering in the app's history view. Build a coverage map by running it once per room.
When to use: Wi-Fi installation verification
-
VPN vs bare-line comparison
iOS+macOSRun two iPerf3 tests (one bare line, one through VPN) and show the delta.
Disconnects the VPN if active, runs an iPerf3 test, reconnects the VPN, runs again, then displays the percentage difference. Useful for benchmarking commercial VPNs or validating that a corporate IPsec tunnel isn't unexpectedly capping throughput.
When to use: VPN diagnosis
-
Menu-bar quick test (macOS)
macOSOne-click iPerf3 test from the macOS menu bar with a 3-second result toast.
macOS-only Shortcut designed to live in the menu bar. Runs a 3-second iPerf3 test against your default server and shows a small toast with the result. Faster than opening the app for spot-checks during the day.
When to use: Quick spot checks from the desktop
Don't see what you need?
Each recipe is a normal Apple Shortcut you can build and edit. To assemble your own from scratch, see the x-callback-url reference for the full list of endpoints, parameters, and result payloads.