Provider

Provider connects iOS devices to ControlFloor. This sets up video streaming from iOS devices to the browser, and also enables the devices to be controlled remotely.

Basic Install Instructions

Clone repos

1. git clone https://github.com/nanoscopic/ios_remote_provider.git
2. git clone https://github.com/nanoscopic/controlfloor.git

Build ControlFloor

1. cd controlfloor
2. Copy example config: cp config.json.example config.json
3. Edit config.json as desired
4. make
5. ./main run

Open https://yourip:8080 to see if ControlFloor is running

Build iOS Remote Provider and CFAgent

1. cd ios_remote_provider
2. Copy example config: cp config.json.example config.json
3. Edit config.json to add your Apple developer details
4. make
5. security unlock-keychain login.keychain # to make sure developer details are there for xcode build
6. make cfa

Register Provider

1. ./main register
2. Press [enter] to register using the default password

Build and setup CF Vidstream App

1. cd repos/vidapp
2. Open the xcode project and install CF Vidstream on the device

Start CF Vidstream App Manually

1. Open the app
2. Click "Broadcast Selector"
3. Click "Start Recording"

Start Provider

1. cd ios_remote_provider
2. ./main run

Automatically starting CF Vidstream App

1. Figure out your device id
   A. ./bin/iosif list
2. Figure out your device UI width/height
   A. ./main winsize B. -or- ./main winsize -id [your device id] C. Observe "Width" and "Height" displayed D. Ctrl-C to stop
3. Add device specific config block to config.json:

   {
       ...
       devices:[
           {
               udid:"[your device id]"
               uiWidth:[your device width]
               uiHeight:[your device height]
           }
       ]
   }
   

4. That's it. The video app will be started automatically when the provider is started.

Using tidevice instead of go-ios

You may wish to use tidevice instead of go-ios to start CFA. Do the following to get it setup:

1. Reconsider using tidevice and don't follow these steps

2. Install tidevice. pip3 install tidevice

3. Add a WDA start method to your config.json:

   {
       ...
       wda:{
           ...
           startMethod: "tidevice"
       }
   }
   

4. Run make usetidevice to auto-generate the calculated.json file containing the location of tidevice installed on your system.

5. Start provider normally; tidevice will be used.