Installation

Installation in a nutshell

We currently provide a .tar.bz2 for easy installation of AirPointr on your Raspberry Pi. The installation is an easy 5 step process:

1. Download the latest release tarball
2. Become root and unpack
3. Run the setup script
4. Check for proper installation
5. Enable the service (optional)

The tar unpacks into the /opt directory so everything is in a single place. Nobody likes having files spilled all over the system so we don't do so.

$ sudo -s
# cd /
# wget https://airpointr.com/pi/latest_release -O airpointr.tbz2
# tar xvpf airpointr.tbz2
# /opt/airpointr/setup.sh
# exit

After you have successfully installed AirPointr, it is time to start the service and setup AirPointr to your needs.

6. Start AirPointr manually
7. Open the web-interface

## Setup script

As some files need to go into specific directories outside "/opt", we provide a setup script that does the steps required. These are:

• Installation of a systemd unit file into /etc/systemd/system
• creation of /etc/airpointr.conf config file (global readonly config)
• creation and proper chmod of /var/lib/airpointr directory (global read/write config and settings storage)
• setting a symlink from /usr/local/bin/airpointr to /opt/airpointr/bin/airpointr

All of these steps can be done manually but we recommend that you simply run the provided shell-script "setup.sh".

Updating from an earlier version

To perform an update of airpointr you simply perform all installation steps again except running the setup.sh script. If an update should require you to run a script in order to make things work, we will tell you so in the download description.

## Check for a proper installation

You can now verify your installation by executing "airpointr" with the "--hardware-id" argument.

$ airpointr --hardware-id

This will give you a hardware ID for your Raspberry Pi which you will need when purchasing a license. Without a license AirPointr will run in a demo mode that will cease to output any gesture data after 30 minutes of system up-time.

## Enabling AirPointr on system boot (optional)

If you are using a systemd based init (Raspbian Jessie, Arch, RuneAudio, ...) you simply type following command to activate AirPointr on startup.

$ sudo systemctl enable airpointr.service

To start the service now just type

$ sudo systemctl start airpointr.service

We currently do not provide startup scripts for non-systemd based init systems. On older Raspbian installations you could simply add AirPointr to your inittab.

## Start AirPointr manually

After you have successfully installed the AirPointr service, it can be started with following command.

$ sudo systemctl start airpointr.service

If you don't want to run AirPointr as a daemon process, you can run it by hand by simply typing

$ airpointr

If you did not run the install script you can call the starter script manually:

$ /opt/airpointr/bin/airpointr

The following table shows all available command lines options.

Option	Description
--verbose	Enable verbose log output.
--syslog	Redirect debug/error output to syslog.
--hardware-id	Query hardware ID.
--set-license	Set license key from .
--show-license	Show license information.
--show-open-source-notice	Show open source software notice.
--reset-password	Clear web frontend's password.
-h, --help	Displays this help.
-v, --version	Displays version information.

Once AirPointr is running it's time to test it and set up the camera using the web-interface.

## Web-interface and gesture preview

AirPointr features a web-interface to allow camera setup and a live-preview of detected gestures.

To reach the config page you simply point your browser to the Raspberry PI's IP on port 8080 (if it has not been changed in the config file).

So if your Pi has the IP address 192.168.0.22 open the URL http://192.168.0.22:8080 in your favorite browser.

## Installing your license file

After your license has been sent to you via e-mail you have to install it. Copy the airpointr.lic file to your Raspberry Pi and issue the following command on the console

$ sudo /opt/airpointr/bin/airpointr --set-license airpointr.lic

This will copy the license information into /etc/airpointr.conf. You can delete the .lic file afterwards but we highly recommend you keep a copy of it in a safe place.

Issues you might run into

Please see our FAQ for issues related to the installation and the execution of AirPointr Raspberry.