Installation Options

Simple installation

For a simple installation/upgrade of TinyPilot, see the instructions in the main README.

Advanced installation

To choose configuration options for the install, specify them in the /home/tinypilot/settings.yml file. These settings would persist on every update too.

Possible variables are available in:

• TinyPilot settings
• uStreamer settings
• nginx settings

Example: custom resolution and release version

Here's an example that installs TinyPilot with a desired capture resolution of 1280x720 and chooses the 1.0.2 version of TinyPilot.

1. Add the installation options to your TinyPilot settings.yml file:

TINYPILOT_SETTINGS="/home/tinypilot/settings.yml"
echo 'ustreamer_resolution: "1280x720"' | sudo tee -a "${TINYPILOT_SETTINGS}"
echo 'tinypilot_repo_branch: "1.0.2"' | sudo tee -a "${TINYPILOT_SETTINGS}"
sudo chown tinypilot:tinypilot "${TINYPILOT_SETTINGS}"

2. run the quick-install script:

curl \
  --silent \
  --show-error \
  https://raw.githubusercontent.com/mtlynch/tinypilot/master/quick-install | \
    bash - && \
  sudo reboot

Example: TC358743 HDMI to CSI capture chip

If you're using a Toshiba TC358743-based HDMI capture chip, the following installation options optimize performance with that chip:

1. Add the installation options to your TinyPilot settings.yml file:

TINYPILOT_SETTINGS="/home/tinypilot/settings.yml"
echo 'ustreamer_capture_device: "tc358743"' | sudo tee -a "${TINYPILOT_SETTINGS}"
sudo chown tinypilot:tinypilot "${TINYPILOT_SETTINGS}"

2. run the quick-install script:

curl \
  --silent \
  --show-error \
  https://raw.githubusercontent.com/mtlynch/tinypilot/master/quick-install | \
    bash - && \
  sudo reboot

Developer installation

If you're interested in contributing to TinyPilot, see the CONTRIBUTING file for instructions on setting up your development environment.

Use proxy

This procedures shows how to install TinyPilot using proxy.

1. get quick-install script.

sudo su
export http_proxy=http://<proxy server address>:<proxy port>/
# if you use proxy which requires login:
# export http_proxy=http://<user id>:<password>@<proxy server address>:<proxy port>/
export https_proxy=${http_proxy}
wget --no-check-certificate https://raw.githubusercontent.com/mtlynch/tinypilot/master/quick-install

2. Edit quick-install and save as quick-install-proxy

sed -e 's/sudo apt-get/sudo -E apt-get/' quick-install > quick-install-proxy
sed -i -e 's/pip install/pip --trusted-host pypi.org --trusted-host files.pythonhosted.org install/' quick-install-proxy
sed -i -e "s/ansible-galaxy install/ansible-galaxy install --ignore-cert/" quick-install-proxy

3. run quick-install-proxy

bash quick-install-proxy && reboot