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 which actions to chain in the Shortcuts app.
Every recipe below maps to the public
x-callback-url scheme, so you can build it today
in the Shortcuts app. On iOS the chain is Open X-Callback URL →
Get Value for result in X-Callback Result → Get Dictionary from
Input → Get Value for summaryText → Quick Look. On macOS the first
step is Open URL instead. The endpoints and parameters are in
the API reference.
Ready-made shortcuts
Four of the chains below are packaged and signed, so tapping one on an iPhone,
iPad or Mac opens it in Shortcuts and adds it in a step. Each runs against the
server you have marked as default in the app, so save a server there first —
without one the shortcut answers serverNotFound.
- iPerf3 Quick Test 5 seconds, TCP, download. The one to reach for during the day.
- iPerf3 Extended Test 30 seconds, TCP, both directions. Use it when a short run looks wrong.
- iPerf3 Jitter Check 10 seconds over UDP, which is what reports jitter and packet loss.
- iPerf3 Last Result Reads the most recent saved result without running a test.
Each one shows the summary in Quick Look when it finishes. To send the numbers somewhere instead, open the shortcut and replace the last step.
Two of these recipes are personal automations, triggered by joining a Wi-Fi network or by the time of day. Apple does not let personal automations be shared as files, so you create the trigger on your device and have it run the shortcut you built.
-
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.