|
|
### Startup for the first time
|
|
|
1. open MaxMSP
|
|
|
2. Go to File > Show Package Manager..
|
|
|
3. switch to 'Installed Packages' and navigate to 'telemersive-gateway'
|
|
|
4. press launch.
|
|
|
5. Follow the instructions.
|
|
|
|
|
|
### Login
|
|
|
|
|
|
![Login](media/TG_config_login_joined.png "Login")
|
|
|
|
|
|
1. Enter your credentials under the tab 'login'. This infos should be treated as confidential and only provided on a need to know basis.
|
|
|
* Router URL: e.g. 'telemersion.zhdk.com'
|
|
|
* Router Port: e.g. 'xxxx'
|
|
|
* Router User: e.g. 'peer-brokeruser'
|
|
|
* Router Pwd: e.g. 'peer-brokerpassword'
|
|
|
2. Network Card: If your machine has more than one network card available, you will have to choose which one you want to use.
|
|
|
3. press 'connect'
|
|
|
|
|
|
If the connection is successful, the red 'disconnect' button gets highlighted and the green 'connect' button greyed-out.
|
|
|
|
|
|
4. Once you are connected, you can now see all the available rooms to join.
|
|
|
5. Enter your room credentials.
|
|
|
* Enter your PeerName
|
|
|
* Select a room from the menu or enter a room name.
|
|
|
* Enter the room password
|
|
|
|
|
|
If the room you enter doesn't exist, a new room will be created and the password will be set as the room password. The password cannot be changed anymore, only once every peer has left the room, the room manager (a service of the telemersive-router) removes the room and again a new room with the same name but with a new password can be created.
|
|
|
|
|
|
6. press 'join'
|
|
|
|
|
|
If the room join is successful, the red 'leave' button gets highlighted and the green 'join' button greyed-out.
|
|
|
|
|
|
7. press 'save' to save all the credentials for your next login. Save also stores your local device settings.
|
|
|
|
|
|
press 'close' to close the [config]-window.
|
|
|
|
|
|
### Closing the app
|
|
|
press the 'quit' button in the upper right corner
|
|
|
|
|
|
![Login](media/GUI_Quit.png "Login")
|
|
|
|
|
|
You will be presented with a choice:
|
|
|
|
|
|
'cancel' will cancel the process.
|
|
|
'No' will quit the app **without** saving the current state.
|
|
|
'Yes' will quit the app **after** saving the current state.
|
|
|
|
|
|
### FAQ
|
|
|
|
|
|
* Using ultragrid, I want to send a Spout stream, but the receiver only gets a black texture.
|
|
|
* Check the local Spout settings. The local machine needs to be able to share textures via GPU (a dedicated GFX-Card). In some instances it was enough to simply open the spout settings (located at C:\Program Files\SPOUT-2007\SPOUTSETTINGS) and confirm with 'OK'
|
|
|
* I am sending a stream, and one machine receives the stream and the other is not.
|
|
|
* Check the firewall. Both Windows and OSX will request a confirmation if a network connection is started (usually only once for each channels).
|
|
|
* Windows: Settings > Update & Security > Windows Security > Firewall and Network protection > Allow an app through the firewall
|
|
|
* look for 'NatNetThree2OSC' and 'uv_tb0' .. 'uv_tb9'
|
|
|
* OSX: System preferences > Security & Privacy > Firewall > Firewall Options
|
|
|
* look for 'uv-qt'
|
|
|
|