Reboot, grab a screenshot, running iOS versions, kill specific running processes, or remove Pokemon Go from multiple devices all from Discord.
Command | Description |
---|---|
list [machine_name] |
Retrieve a list of devices from all machines or a specific one. |
iosver [machine_name] |
Retrieve a list of iOS versions running on devices for all machines or a specific one. |
screen iPhone1, iPhone2 |
Take a screenshot of specific device(s). |
sam iPhone1, iPhone2 |
Reapply Single App Mode profile for provided device(s). |
reopen iPhone1, iPhone2 |
Send restart game request to device(s). |
reboot iPhone1, iPhone2 |
Reboot specific device(s). |
shutdown iPhone1, iPhone2 |
Shutdown specific device(s). |
resign https://mega.nz/file/yS7C#Dsh0lZDkk 1.33.0b1 iPhone1,iPhone2 |
Download latest app, resign, and deploy to specified devices (leave blank or specify All for all devices connected to the machine) |
deploy iPhone1,iPhone2 |
Deploy latest already signed app from releases folder to specific device(s). |
rm-pogo iPhone1,iPhone2 |
Removes Pokemon Go from specific device(s). |
kill usbmuxd [machine_name] |
Kill a specific process such as usbmuxd . |
Notes:
- Parameters in brackets
[ ]
are optional - When specifying device names, spaces between commas is supported. i.e
!reboot iPhone1, iPhone2
- Best used with the same bot token if deploying to multiple machines. Devices not found will be skipped when executing commands.
Run the following commands and fill out config.
wget https://github.com/raw/versx/iPhoneController/master/install.sh && chmod +x install.sh && ./install.sh && rm install.sh
After building iPhoneController
for the first time:
- In your
bin
folder, create areleases/config
folder - Copy your GC
config.json
to the newreleases/config
folder - In your
bin
folder, create aprofiles
folder - Copy your mobile provisioning profile to the new
profiles
folder
In order to reapply the SAM profile, you'll need to do the following:
- Copy
sam_pogo.mobileconfig
to yourbin
folder - In AC2, click on the
Apple Configurator 2
menu and chooseInstall Automation Tools
. - In AC2, click on the
Apple Configurator 2
menu and choosePreferences
>Organization
> click on your org and chooseExport Supervision Identity
at the bottom left, then change format toUnecrypted DER
. - Move the .crt and .der files to your
bin
folder and rename them toorg.crt
andorg.der
.
git pull
(from root of folder)~/.dotnet/dotnet build
cd bin
~/.dotnet/dotnet iPhoneController.dll
From the bin
folder type the following:
~/.dotnet/dotnet iPhoneController.dll
Once everything is setup and running appropriately, you can add this to PM2 ecosysetm.config.js so it automatically starts:
module.exports = {
apps: [
{
name: "iPhoneController",
script: "iPhoneController.dll",
watch: false,
cwd: "/path/to/iPhoneController/bin",
interpreter: "/Users/you/.dotnet/dotnet",
instances: 1,
exec_mode: "fork",
max_restarts: 250,
restart_delay: 300
}
]
}
Adjust path and interpreter as required.
If you have useIosDeploy=false and the bot doesn't respond, check console. If you get the following error or similar you will need to fix PM2 permissions, see below.
1|iPhoneController | 21:49 [ERROR] [BOT] User xxx tried executing command screen and unknown error occurred.
1|iPhoneController | : System.NullReferenceException: Object reference not set to an instance of an object.
1|iPhoneController | at iPhoneController.Commands.PhoneControl.ScreenshotAsync(CommandContext ctx, String phoneNames) in
/private/path/to/iPhoneController/src/Commands/PhoneControl.cs:line 115
- From Mac terminal
cat ~/Library/LaunchAgents/pm2.admin.plist
look for the following line and note the path
<string>/usr/local/lib/node_modules/pm2/bin/pm2 resurrect</string>
- From Mac desktop, Click the Apple, Open System Preferences
- Click Security and Privacy, click the lock to make changes and enter your password
- On left, click full disk access then either click the plus and add the path from earlier OR open finder and navigate to the path and drag / drop into here
If you've already started iPhoneController with PM2 you'll now want to delete and relaunch after the above changes, this will now let PM2 access the files needed to run cfgutil.
Q. How do I get the profile ID?
A. Run security find-identity -p codesigning
Q. I'm receiveing {"Command":"list","Output":{},"Type"::CommandOutput","Devices":[]}
when cfgutil --format JSON list
is run.
A. Reinstall Apple Configurator 2 automation tools
Q. I'm trying to reapply SAM but get error "failed to get ECID for device"?
A. You likely have useIosDeploy = true
, you need this to be "false" which uses cfgutil
in order to support re-applying SAM.
- Localization