Wi-Fi

After a one-time setup with the cable, Jiggle Mode can reach your iPhone or iPad over Wi-Fi when both are on the same network.

#Set it up once

1. Plug the phone into your Mac with a cable and unlock it. It must already trust your Mac.
2. Click the Jiggle Mode icon in the menu bar and choose Set Up Wi-Fi…, then Set Up. Or, in Terminal, run:

jigglemode wifi setup

The phone already trusts your Mac, so it doesn't ask anything. It does add your Mac to its list of paired computers. Your Mac keeps a key for that phone in your login Keychain.

#What to expect afterwards

• Jiggle Mode can find the phone over Wi-Fi when it is unlocked and on the same network as your Mac.
• Connecting over Wi-Fi takes a moment longer than the cable (about half a second for each connection, in our tests).
• The first time, macOS may ask whether Jiggle Mode (or the app you run jigglemode from, such as Terminal or your agent app) may find devices on your local network. Click Allow; see Local Network permission if you clicked Don't Allow.
• Asking a phone to trust your Mac (jigglemode pair) only works over the cable.

To see which phones are set up, and whether each is on your network right now (this and the next command need the jigglemode command):

jigglemode wifi status

#Changes over Wi-Fi

Reading works over Wi-Fi right after setup. Applying changes over Wi-Fi is off for each phone until you turn it on; with it off, plug in the cable to apply (with the cable in, the cable is always used). To turn it on or off for a phone:

jigglemode wifi changes on
jigglemode wifi changes off

Turning them on asks you to type allow in Terminal. It can't be done by a program or an AI agent running the command for you: without a terminal to ask in, the command refuses. This is new and hasn't been tried on a phone yet; keep the cable at hand.

#Forget a phone

jigglemode wifi forget

deletes your Mac's Wi-Fi key for the phone. The phone itself isn't changed; to use Wi-Fi again, run jigglemode wifi setup with the cable. If several phones are set up, choose one with --device <UDID> (the UDIDs are listed by jigglemode wifi status).

Jiggle Mode can't tell the phone to forget your Mac, so the phone still accepts the deleted key. To remove your Mac from the phone's trusted computers, use the phone: Settings, General, Transfer or Reset iPhone, Reset, Reset Location & Privacy. What that costs:

• The phone forgets every computer it trusts, over the cable too: each one shows "Trust This Computer?" again, and Wi-Fi has to be set up again.
• It also resets the location and privacy permissions of your apps.
• It is Apple's reset for trusted computers. That it also removes Wi-Fi keys is expected but hasn't been confirmed yet.

#If you used Wi-Fi with an earlier version

Before 1.0.0-rc.1, test versions of Jiggle Mode kept your Mac's Wi-Fi key in a plain file in Jiggle Mode's folder. This version moves keys to the Keychain: the first time it sees such a file it replaces it with one that holds no key, and asks you to set Wi-Fi up again.

That does not make the old key useless. The phone still accepts it, and copies of the old file may remain in Time Machine backups or disk snapshots. Anyone with such a copy, on the same network as your phone, could connect to it as your Mac. Jiggle Mode can't revoke the key from the Mac; only the phone can, with Reset Location & Privacy as described above, with the same costs. jigglemode devices, jigglemode wifi status, jigglemode wifi setup and jigglemode wifi forget say this when it applies to a phone.

#If Wi-Fi setup fails

Setup checks that the phone proves its identity the way every Wi-Fi connection will, and saves nothing unless it does. That check follows a message format Apple doesn't document, so it may not match a real phone yet. If it fails, the message names the check that failed and ends with a line of details for a report (message types and sizes only, never a key).

• If it says Jiggle Mode stopped before pairing, nothing changed on your phone.
• If it says your iPhone paired, your phone now holds one Wi-Fi key from your Mac that nothing will use. To remove it, use Reset Location & Privacy as described above. Don't run jigglemode wifi setup again until there is a fix: each try would leave one more such key.

Either way the cable keeps working. Please send the message to hello@jigglemode.com.

#If something on the network can't prove it is your phone

Every Wi-Fi connection checks that the phone proves it holds the key recorded at setup, before Jiggle Mode sends anything. If something answers for your phone without that proof, even with a reply that says your Mac's key is refused, Jiggle Mode reports it as unverified, sends nothing, and asks you to use the cable. That alone is no reason to set Wi-Fi up again: do that only if you erased or reset your phone. If it keeps happening on one network, something on it may be imitating your phone.