Tinyphone
Docs Command line

Command line

The Mac app's engine in a terminal. JSON out, --text for people.

Install

In Tinyphone for Mac, Settings, Install Command Line Tool links tinyphone into /usr/local/bin. Remove Command Line Tool takes it out again. The tool works on the phone on this Mac’s cable.

Reading

commandwhat it gives
tinyphone phonesthe phones on the cable: iOS, supervised, ours or not
tinyphone inspectevery profile, app and property the phone carries
tinyphone modesthe phone’s saved modes, the active one starred
tinyphone historywhat this Mac did to the phone, newest first
tinyphone profiles listthe phone’s own profile list
tinyphone backupsthe backups on this Mac
tinyphone doctorApple Configurator present, this Mac’s identity, the phone paired

Changing the phone

commandwhat it does
tinyphone apply --preset kida mode onto the phone, then the phone read back; kid, easy, focus or dumbphone
tinyphone apply --mode mode.jsonyour own mode, as the JSON the Mac app saves
tinyphone profiles remove <id>one profile off the phone
tinyphone profiles sweepevery profile of ours off the phone
tinyphone backupthe phone backed up into this Mac’s MobileSync folder
tinyphone restorethe phone’s own backup back onto it; --source <udid> for another
tinyphone fresh --preset kiderase and set the phone up again; asks you to type the phone’s name, --yes skips it

Flags

flagfor
--ecid <ecid>which phone, when more than one is on the cable (tinyphone phones lists them)
--textlines for people instead of JSON
--setupapply the mode as setup leaves it: the App Store and Safari kept, so the apps that stay can be installed

Exit codes

codemeans
0done
1failed
2the phone is locked: unlock it and run again
3this Mac’s supervision identity was refused
4Apple Configurator’s cfgutil is missing
5no phone on the cable
6bad arguments