Installation

Windows

Download the latest .exe installer from:

https://github.com/endarthur/os/releases/latest

When updating, please uninstall the previous version before installing the new.

The releases also contain an experimental portable executable for OpenStereo, with a name starting with OpenStereo_Portable followed by the build date. Please report any issues when using the portable version.

Windows XP

Download and execute WinPython-32bit-3.4.4.1Qt5.exe from sourceforge. Python 3.4 is the last python available for Windows XP, and winpython is a portable distribution pre-packaged with most of the prerequisites for OpenStereo. Inside the folder you just extracted, execute the WinPython Command Prompt, and install OpenStereo using:

pip install https://github.com/endarthur/os/tarball/master#egg=openstereo

After that, you may either open the WinPython Command Prompt and run:

python -m openstereo

Or create a shortcut, by right clicking on your desktop, selecting new, shortcut, browsing to the file python-3.4.6\pythonw.exe inside the folder and adding the parameter -m openstereo after the file, as such:

_images/winxp_shortcut.png

The icon for OpenStereo is located inside the ui_files/icons directory on the github repository, or downloaded with this link.

macOS Installation

First install pyqt5 and python3 (python3 is automatically installed as a dependency of pyqt5) using homebrew:

$ brew install pyqt

Once that is done, install OpenStereo from github using pip3:

$ pip3 install git+https://github.com/endarthur/os#egg=openstereo

Ubuntu

First install pyqt5 and pip:

$ sudo apt install python3-pyqt5 python3-pip

Once that is done, install OpenStereo from github using pip3:

$ pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

Mint Cinnamon

First install pyqt5, pip and setuptools from the distribution repository:

$ sudo apt install python3-pyqt5 python3-pip python3-setuptools

Then install wheel using pip:

$ pip3 install wheel

Once that is done, install OpenStereo from github using pip3:

$ pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

Fedora

First install pyqt5:

$ sudo yum install python3-qt5

Once that is done, install OpenStereo from github using pip3:

$ sudo pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

openSUSE

First install pyqt5:

$ sudo zypper install python3-qt5

Once that is done, install OpenStereo from github using pip3:

$ sudo pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

Arch Linux

First install pyqt5 and pip:

$ sudo pacman -S python-pyqt5 python-pip

After that, install openstereo from github using pip:

$ sudo pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

Installing pyqt5 from pip also works, in case there is any issue installing with pacman.

Other Linux distros

In general, install pyqt5 for python3, either from the distro repositories or PyPI. PyQT5 is not listed as a requirement on OpenStereo’s setup file, as its installation may fail in some cases, though the other requirements can usually be installed automatically without any issues.

After installing pyqt5, install openstereo using pip3 (to force it to use python3):

$ pip3 install https://github.com/endarthur/os/tarball/master#egg=openstereo

You may either have to run this command with sudo or by adding the --user flag to pip3. In case you use the flag, you’ll have to run OpenStereo using:

$ python3 -m openstereo

Instead of just openstereo, though you can add this as an alias to your .bash_aliases file.

From PyPI

At the command line:

pip install https://github.com/endarthur/os/tarball/master#egg=openstereo

Additionally, install PyQt5 from PyPI if needed (for python 2.7, use package python-qt5 instead).