CameraBridge Server

CameraBridge is simple, fast, and secure proxy server software that modifies your IP camera feeds for easy integration with SplashTiles or standard web browser windows.
CameraBridge is INCLUDED for free with your current PRO subscription.

CameraBridge Server features

Setup instructions
First you need to select the hardware CameraBridge will run on:

Prepare your hardware (instructions for Raspberry Pi)
  1. Download the Raspberry Pi OS (Lite version, 32b) (Manual or installer, your choice) Link
  2. After you have created your SD card, add the 'ssh' file to the /boot partition to enable ssh. This is just an empty file named 'ssh', create with touch ssh in linux.
  3. Boot up your Pi. Find it's IP address
  4. Connect using SSH (either Linux or PUTTY)
  5. Login using user=pi, password=raspberry
Now install CameraBridge
  1. Switch to root user (sudo su)
  2. Download our DEB package.
    • PC running 64b linux (x86_64/amd64): wget https://splash-tiles.com/help/deb/camerabridge_amd64.deb
    • Raspberry PI (all types, armhf): wget https://splash-tiles.com/help/deb/camerabridge_armhf.deb
  3. apt-get update
  4. apt-get install ./camerabridge_XXXX.deb (either amd64 or armhf)
  5. Most likely you will want CameraBridge to autostart. On PI, just edit /etc/rc.local and add the line
    /usr/local/bin/camerabridge >/dev/null 2>&1 &
  6. Other Linux distributions often have different startup files. Consult the oracle Google.
  7. If your device will use DHCP, goto your router and reserve the current DHCP address. Otherwise, set the desired static ip. (IP address must be known and unchanging)
Finally, configure CameraBridge
  1. Enter http://device_ip:9087 in a browser window
  2. Enter your SplashTiles username and password
  3. If you would like token auth, enter your token (any string)
  4. If you need HTTPS, continue below. Otherwise, you are done!

HTTPS setup and security considerations
This section is optional (only required if you will port forward CameraBridge port 9089 to the internet).

  1. HTTPS requires an unique SSL key/certificate pair for your server. You must generate this and link it in the config page before port 9089 will be active.
  2. CameraBridge includes the ability to LIMIT external access to only the URLS you specify
    • Using this feature is HIGHLY recommended. It limits external access even if your token is compromised.
    • Create a text file with all the internal URLs you need to access. Include the http(s):// and the full path, but leave out any arguments (the '?' and anything after it).
    • One URL per line of the text file.
    • Put the text file on your server. Include the full path to the file on the CameraBridge config page.
Self signed vrs Cert Authority signed certificates

API reference
Here is the full protocol documentation for CameraBridge server. You can use this to manually setup tiles, automation access, or direct web browser access.
Port 9087:
Accessing this port (with any path) will give you the web configuration page. This is just a simple HTML form to set the values in the camerabridge.conf file. This file is normally located at /etc/camerabridge.conf. However, you can also use command line argument 1 to provide an alternate path to the configuration file.

Port 9088:
The is the http proxy port. This is intended for accesses from devices on your local network.
Port 9089:
This is the secure proxy port (https). The secure port has the same paths and parameters as port 9088 above.
If you have set an Allowed URL file (in config), only URLs which match the URLs in the file will be allowed.