Skip to content

Latest commit

 

History

History
154 lines (113 loc) · 5.11 KB

install.md

File metadata and controls

154 lines (113 loc) · 5.11 KB
Raw

Linux Runtime Installation

The following installation guide uses a minimal Ubuntu 22.04 desktop installation, but it should also work for other Linux distributions. With some adaptation this also works on macOS and Windows, but we leave this exercise to the reader.

We highly recommend using a dedicated virtual machine, especially if you are not yet familiar with setting up a Qt runtime environment.

Install Qt with dynamic Qt libraries

This is only required for non-static builds of the remote-ui app!

The remote-ui simulator is a Qt application and requires the Qt framework library. Installing Qt with the system's package manager usually doesn't work. We suggest using Another Qt installer(aqt) to install the required Qt runtime.

Install aqt installer

sudo apt install python3-pip
pip install aqtinstall

Add the local binary directory ~/.local/bin to the search path (if not yet included):

  1. Edit ~/.bashrc
  2. At the end of the file, add: PATH="$HOME/.local/bin:$PATH"

Install Qt Runtime

Requirements:

  • Qt version: 5.15.2
  • Qt features: multimedia, qml, quick, quickcontrols2, virtualkeyboard, websockets,
mkdir ~/Qt
aqt install-qt --outputdir ~/Qt linux desktop 5.15.2 gcc_64 -m qtvirtualkeyboard

Notes:

  • Most Qt modules are already included in the default installation and therefore not included in the module parameter.
  • See aqtinstall docs for further information.

Configure Environment

Some environment variables need to be set for the installed Qt runtime. aqtinstall will not set them automatically, to not interfere with an existing installation.

export QT_VERSION=5.15.2
export QTDIR="$HOME/Qt/$QT_VERSION/gcc_64"
export PATH="$QTDIR/bin:$PATH"
export LD_LIBRARY_PATH="$QTDIR/lib:$LD_LIBRARY_PATH"
export QT_PLUGIN_PATH="$QTDIR/plugins"
export QT_QPA_PLATFORM=wayland

Attention if not using Ubuntu 22.04: QT_QPA_PLATFORM must be set to the correct graphical environment.
E.g. for Lubuntu it's already set to lxqt. See Qt docs for more information.

If you are using a dedicated VM, you can add the required environment variables to the end of ~/.profile. Otherwise, it's better to create a start script for launching the simulator.

Fonts

The remote-ui uses the following Google fonts families:

These fonts are licensed under the Open Font License.

Fonts installation

  1. Create a .fonts directory in your home directory: mkdir ~/.fonts
  2. Download both fonts zip files
  3. Extract all .ttf files into ~/.fonts

Container Runtime

The remote-core simulator is available as Docker image. One can either use Docker or Podman as container runtime.
Let's use Docker for easier Home Assistant setup.
Head over to https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-22-04 for detailed instructions. In short:

sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce
# add user to docker group. Log out and back in afterwards
sudo usermod -aG docker ${USER}

Alternative: Podman

sudo apt install podman

If you'd also like the Docker aliases:

sudo apt install podman-docker

Integrations

Home Assistant

Run the container:

docker run -d \
  --name uc-intg-hass \
  --restart=unless-stopped \
  -e TZ=UTC \
  docker.io/unfoldedcircle/intg-hass:latest

Container

Host

The remote-core simulator is a statically compiled binary with very little external dependencies:

sudo apt install libavahi-compat-libdnssd1

Home Assistant Server

If you don't already have a Home Assistant installation you can easily install one in a container to get started with the UC home-assistant integration for Remote Two.

Create configuration directory on the host:

mkdir ~/hass_config

Run the container - replace the TZ value with your time zone:

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=UTC \
  -v ~/hass_config:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

Open a web browser at http://localhost:8123 and start the onboarding.
Afterwards go to your user profile (your name, bottom left) and create a long-lived access token to access the Home Assistant API with the UC home-assistant integration. Copy and save it in your password manager.

For further information please see: https://www.home-assistant.io/installation/linux