Installation Instructions

manuelnaranjo edited this page Aug 24, 2011 · 22 revisions

Installation Instructions



Android Version

In order to get AIRi running on your Android powered device first you need to make sure your device is 2.0 compatible (most devices are: Eclair, Froyo and Gingerbread are all 2.0 compatible). 3.X devices should be compatible, but haven't been tested yet, please report any problem so we can fix it.


You will also need to install Python For Android Py4A , right now you need to install Py4A r7b1. You can do it by scanning this barcode with your device.

QR barcode Py4A

Latest version is always available in our Downloads section, you can click on the apk file name and you will get a QR bar code that you can scan with your device.

QR barcode AIRi

Latest version (15 June 2011)

Launching AIRi

Once you have AIRi installed you can launch it by simple clicking on the icon you get into the application list.

AIRi server will get assigned a random port number, so unless you use adb logcat to tell the port number, you can't by now connect from another computer to your camera.


You can install AIRi in Linux in several ways, one of this ways is totally automated, the other one requires some attention from you. The first one is the preferred installation process, while the second one targets more advanced users.

Installing using apt-get in Ubuntu

Using the Graphical User Interface

Ubuntu comes with several handy graphical user applications that will help you install AIRi with just a few clicks.

First start Ubuntu Software Center by clicking HERE. If it fails opening you can always launching with the desktop icons

Once you started the tool you will need to add AIRi PPA: Open the edit menu, and choose software sources

Now select the Other Software tab, and from there click on Add

Now type in the AIRi PPA url: ppa:manuel-aircable/airi

Choose Add Source and then close the Software Sources window, you will notice an In Progress... icon will come up, you will have to wait until it completes, once done you need to close the Ubuntu Software Center

Open up Ubuntu Software Center again, and search for AIRi, select install in the shown result.

Installing Using the command line

You can also install AIRi by just using the command line, run the following commands and you should get AIRi installed.

sudo add-apt-repository ppa:manuel-aircable/airi
sudo apt-get update
sudo apt-get install airi
Launching AIRi

What ever method you choose to install AIRi, the launch process is the same, open up a terminal

Then run the following command:

/opt/AIRi/bin/AIRi <port>

If you don't pass any port as argument then the application will be available in port 8000, otherwise the one you passed in.

Installing from PyPy

Installing in Linux is rather easy, you just need to have pip installed into your system. With Python 2.6 or 2.7 (3.X not tested yet but may work), here we provide instructions for Ubuntu, but any other distribution should be compatible as long as you can install the requirements (pip and PyBlueZ)

First you need to have PyBluez, you can get it installed in Ubuntu by running:

sudo apt-get install python-bluez

If you don't have pip all ready installed you can get it by running:

sudo apt-get install python-pip

You can install or update AIRi by running:

sudo pip install --upgrade airi

Launching AIRi

Starting AIRi is rather simple, just type in AIRi in a shell, and point your browser to: localhost:8000, if you want to access from another computer then point to <ip>:8000 where <ip> is the IP address for the computer running AIRi.

If you're running AIRi in a server without X session (headless) then you need to run with super user rights:

sudo AIRi

If you want you can change the port number by passing it as argument to AIRi, for example to use port 10000.

sudo AIRi 10000


Please note that Windows in 64 bit mode is not supported yet.


Dependencies for 32 bits Windows (XP, Vista, 7)

In order to install AIRi package first you need to install a few dependencies, you need to install this only the first time, if asked choose Python 2.6 (will happen only if you have other versions of Python installed):


Last step is to get AIRi it self installed, again if asked about which Python version to use choose Python 2.6 by now.

Launching AIRi

AIRi installer will create a shortcut exe file into <Python26>ScriptsAIRi.exe, if Python2.6 is installed into the default path then you can launch AIRi by double clicking on C:Python26ScriptsAIRi.exe, you can create an icon in your desktop to launch it easier.

Once you started AIRi you can connect and manage your cameras from http://localhost:8000



Installing in Mac OSX is a long but still easy to do, first of all you need to get XCode installed, because we're going to need to build some binary extensions.

Once XCode is installed you need to get virtualenv:

curl -o

Now we need to create our self contained Python environment for AIRi so we don't mess up with the system:

python AIRi-MacOSX

From the AIRi-MacOSX folder we can now install AIRi:

cd AIRi-MacOSX
source bin/activate
pip install airi

If pip isn't available in your Mac then you can install it by doing

easy_install distribute

After you did source bin/activate, then you can go on with the installation process.


AIRi can always be started by running

<AIRi-MacOSX path>/bin/AIRi <portnumber>

Where <AIRi-MacOSX path> is the place where you created the AIRi virtualenv, you can also pass <portnumber> if you want to use any port different from 8000.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.