Testing:Linux Testing Environment

Verify Installation
To verify the installation checkout the source code of OpenLP and run the following script:

python OPENLP_SRC/scripts/check_dependencies.py

The output should be similar to the following:

Python >= 2.6 ... 2.7.0.final.0 Checking for modules... PyQt4... OK PyQt4.QtCore... OK PyQt4.QtGui... OK PyQt4.QtNetwork... OK PyQt4.QtOpenGL... OK PyQt4.QtSvg... OK PyQt4.QtTest... OK PyQt4.QtWebKit... OK PyQt4.phonon... OK sqlalchemy... OK sqlite3... OK lxml... OK chardet... OK enchant... OK BeautifulSoup... OK mako... OK Checking for optional modules... sqlite (SQLite 2 support)... FAIL MySQLdb (MySQL support)... OK psycopg2 (PostgreSQL support)... OK Verifying version of modules... PyQt4 >= 4.6 ... 4.8.3 Qt4 >= 4.6 ... 4.7.3 sqlalchemy >= 0.5 ... 0.6.8 enchant >= 1.3 ... 1.3.1 Qt4 image formats...  read: bmp, gif, ico, jpeg, jpg, mng, pbm, pgm, png, ppm, svg, svgz, tif, tiff, xbm, xpm write: bmp, ico, jpeg, jpg, png, ppm, tif, tiff, xbm, xpm Enchant (spell checker)...  available backends: myspell, aspell available languages: en_HK, en_GB, en_TT, en_NG, en_BW, en_IN, en_BZ, en_AG, en_BS, en_CA, en_PH, en_US, en_NA, en_JM, en_ZW, en_DK, en_GH, en_ZA, en_IE, en_SG, en_AU, en_NZ, cs, en

Installing on Kubuntu
OpenLP is supported on Ubuntu 10.04 and up.

Install Dependency Packages
user@linux:~ $ sudo apt-get install python-setuptools python-support python \ qt4-dev-tools python-qt4 python-qt4-phonon python-sqlalchemy \ python-chardet python-beautifulsoup python-lxml python-sqlite \ python-enchant python-mako python-migrate python-qt4-gl \ python3-sip alembic

Ubuntu Notes
At the time of writing, there are known problems with media for some Gnome installations.

Installing libxine-ffmpeg and/or phonon-backend-gstreamer might help with these. You may also need to remove phonon-backend-xine Installing kubuntu-restricted-extras has been reported to fix the media issues for regular Ubuntu 10.04 (gnome) installs. The ubuntu-restricted-extras meta-package is also needed.

Install Qt 4
The recommended version of Qt4 is version 4.4.0 or higher

Version 4.4.3 is the default version of Qt 4 on Fedora 10. If you don't have KDE or Qt4 installed, you'll need to install it with the following command:

user@linux:~ $ pkcon install qt-x11

Install PyQt4
The recommended version of PyQt4 is version 4.4.0 or higher

Version 4.4.3 is the default version of PyQt4 on Fedora 10. If you're using a previous version of Fedora, you'll need to make sure you get hold of version 4.4.0. You can install PyQt4 with the following command:

user@linux:~ $ pkcon install PyQT4

Install SQLAlchemy
The recommended version of SQLAlchemy is version 0.5 or higher

Installing SQLAlchemy on Fedora is a very simple affair: user@linux:~ $ pkcon install python-sqlalchemy

Install Chardet
To get the bibles to work with the unicode settings Chardet is required

Installing Chardet on Fedora is a very simple affair: user@linux:~ $ pkcon install python-chardet

Install BeautifulSoup
To get the bibles to work with the unicode settings BeautifulSoup HTTP parser is required

Installing BeautifulSoup on Fedora is a very simple affair: user@linux:~ $ pkcon install python-BeautifulSoup

Install Phonon
To allow the media plugin to function

Installing Phonon on Fedora is a very simple affair: user@linux:~ $ pkcon install phonon

You also need python-enchant and python-lxml

user@linux:~ $ pkcon install python-enchant python-lxml

Python 3 Dependencies
For python 3 there are some new dependencies and packages have slightly different names. To install necessary dependencies for python 3 do:

user@linux:~ $ sudo yum install python3-PyQt4 python3-sqlalchemy python3-alembic python3-lxml python3-chardet python3-enchant python3-beautifulsoup4 python3-mako libreoffice-pyuno python3-psycopg2 python3-nose python3-mock

Installing setuptools
setuptools is needed to install some packages not included in Mandriva.

user@linux:~ urpmi python-setuptools

Install chardet and SQLAlchemy
To install chardet and SQLAlchemy we must use easy_install as root

user@linux:~ easy_install chardet user@linux:~ easy_install SQLAlchemy

Install lxml and beautifulsoup
user@linux:~ urpmi python-lxml python-beautifulsoup

Install phonon
user@linux:~ urpmi phonon -a

This will install all the phonon packages. These are required to get OpenLP up and running.

Installing on OpenSUSE
These instructions assume you're running OpenSUSE 11.4 or greater (Older versions are no longer supported by OpenSUSE and are unavailable as OBS build targets) with KDE as you're main desktop environment. There are two methods for installing OpenLP on OpenSuse. The first is to use 1-click install through YaST. The other is to use zypper to add the proper repository and install openLP.

One Click Install
Click the appropriate link below for your version of OpenSUSE and follow the YaST Wizard.

OpenSUSE 12.1

OpenSUSE 11.4

OpenSUSE 12.1
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper install OpenLP

OpenSUSE 11.4
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_11.4 python-obs user@opensuse:~ $ sudo zypper install OpenLP

Installing Development version from a package (RPM)
'''Warning!!!!: While it generally works there is no guarantee that any particular version from bazaar won't break everything. If you just need something that works reliably use the packages as described above. Use at your own risk.'''

Use this method you want to run the version from the nightly tarball. This will give you the same version that you would get by using the nightly tarball with the following advantages.

Advantages

 * Installs to system just like the release version
 * Managed with OS package management tools (i.e. zypper and YaST)
 * Automatic daily updates through YaST/zypper

Disadvantages

 * Automatic daily updates through YaST/zypper, accidental upgrades could break things for you

One Click Install
Click the appropriate link below for your version of OpenSUSE and follow the YaST Wizard.

Note: If you deselect the "Remain Subscribed to these repositories after installation" checkbox, OpenLP won't automatically update unless you do the one-click install again. This could be used as a method of only upgrading on purpose.

OpenSUSE 12.1

OpenSUSE 11.4

OpenSUSE 12.1
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper addrepo obs://home:jdmulloy:openlp-nightly/openSUSE_12.1 openlp-nightly user@opensuse:~ $ sudo zypper install OpenLP

If you want to prevent OpenLP from automatically updating you can disable the openlp-nightly repo with the following command

user@opensuse:~ $ sudo zypper modifyrepo --disable openlp-nightly

In order to upgrade OpenLP you'll re-enable the repo with the following command

user@opensuse:~ $ sudo zypper modifyrepo --enable openlp-nightly

OpenSUSE 11.4
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_11.4 python-obs user@opensuse:~ $ sudo zypper addrepo obs://home:jdmulloy:openlp-nightly/openSUSE_11.4 openlp-nightly user@opensuse:~ $ sudo zypper install OpenLP

If you want to prevent OpenLP from automatically updating you can disable the openlp-nightly repo with the following command

user@opensuse:~ $ sudo zypper modifyrepo --disable openlp-nightly

In order to upgrade OpenLP you'll re-enable the repo with the following command

user@opensuse:~ $ sudo zypper modifyrepo --enable openlp-nightly

Installing Development version from Bazaar or nightly tarballs
'''Warning!!!!: While it generally works there is no guarantee that any particular version from bazaar won't break everything. If you just need something that works reliably use the packages as described above. Use at your own risk.'''

Use this method if you want to run the development version of openLP from bazaar or from a nightly tarball. This method will install all of the dependencies necessary to run OpenLP from the OpenSUSE repositories through zypper. Once you have completed the steps below for your version of OpenSUSE follow the instructions on the Testing:Getting Started page. If you want to pull code from Bazaar you will need to install the client in addition to the dependencies for openLP.

Install bazaar client (Optional)
You only need to do this if you plan on using bazaar. If you are only going to use the nightly tarballs you don't need the bazaar client. user@opensuse:~ $ sudo zypper install bzr

OpenSUSE 12.1
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper install phonon python-beautifulsoup python-chardet python-pyenchant python-lxml python-mako python-sqlalchemy python-sqlalchemy-migrate python-qt4 hicolor-icon-theme libreoffice-impress libreoffice-pyuno

OpenSUSE 11.4
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper install phonon python-beautifulsoup python-chardet python-pyenchant python-lxml python-mako python-sqlalchemy python-sqlalchemy-migrate python-qt4 hicolor-icon-theme libreoffice-impress libreoffice-pyuno