rodionp13/stf_ios_support

Central repo to connect and document components/repos needed for IOS stf support

STF IOS Support

Build machine setup

1. Clone this repo down to your build machine

2. Install XCode

3. Add your developer Apple ID to XCode

   1. XCode -> XCode menu -> Preferences -> Accounts Tab
   2. + under Apple IDs list
   3. Choose Apple ID
   4. Login to your account so that dev certs can be downloaded

4. Run ./init.sh

Deploy server side:

1. On your STF server machine

   1. Pull STF server image docker pull openstf/stf

   2. Copy docker-compose.yml and .env from server/

   3. Generate certs for your system / domain

   4. Update docker-compose.yml cert paths and .env

   5. Start STF

      1. docker-compose up

Build provider files:

1. Update config.json

2. Run make dist

   1. offline/dist.tgz will be created

Deploy provider setup:

1. Copy offline/dist.tgz from build machine
2. Run tar -xf dist.tgz
3. Tweak config.json as desired

Starting provider

1. Run ./run ( and leave it running )
2. Plugin one or more IOS device(s)
3. Permissions dialog boxes appear; select accept for all of them
4. Device(s) shows up in STF with video and can be controlled. Yay

Setting up with VPN

1. Install openvpn-server on your STF server machine
2. Create client certificate(s) using your favorite process...
3. Create ovpn file(s) with those client certs
4. Deploy those cert(s) to your provider machines; setting them up in Tunnelblick
5. Alter config.json on each provider to have the name of the cert setup in Tunnelblick
6. Start openvpn server on STF server
7. Start coordinator/provider on each provider machine

Handling video not working

1. Run ./view_log -proc ffmpeg to check for errors from ffmpeg
2. Run ./view_log -proc mirrorfeed to check for errors from video feed process
3. Reboot your IOS device and try again

Increase clicking speed

1. Jailbreak your IOS device

2. Install Veency through Cydia

3. Configure a VNC password if desired

4. Alter config.json

   1. Set "use_vnc": true
   2. Set "vnc_scale": 2 ( or 3 depending on your device scale )
   3. If password used, set "vnc_password": "[your password]"

5. Start coordinator

6. Clicking is now nearly immediate!

Debugging

1. run ./view_log to see list of things that log
2. run ./view_log -proc [one from list]