Installation Instructions
Contents
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.
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.
Latest version (15 June 2011)
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.
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.
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
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 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
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.
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):
- http://www.python.org/ftp/python/2.6.6/python-2.6.6.msi
- http://pybluez.googlecode.com/files/PyBluez-0.18.win32-py2.6.exe
- http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11.win32-py2.6.exe
- http://twistedmatrix.com/Releases/Twisted/11.0/Twisted-11.0.0.winxp32-py2.6.exe
- http://pypi.python.org/packages/2.6/z/zope.interface/zope.interface-3.5.0.win32-py2.6.exe
- https://github.com/downloads/manuelnaranjo/AIRi/Jinja2-2.5.5.win32-py2.6.msi
Last step is to get AIRi it self installed, again if asked about which Python version to use choose Python 2.6 by now.
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 virtualenv.py https://raw.github.com/pypa/virtualenv/develop/virtualenv.py
Now we need to create our self contained Python environment for AIRi so we don't mess up with the system:
python virtualenv.py AIRi-MacOSX
From the AIRi-MacOSX folder we can now install AIRi:
cd AIRi-MacOSX source bin/activate pip install airi deactivate
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.