Testing:Getting Started

So you want to help out with testing, and your next question is, "How do I get started?"

Hang out in the IRC channel with us
A number of the developers and testers chat in the #openlp.org IRC channel (live chat). We don't have a specific topic of conversation, and we don't restrict the topics to OpenLP-related ones. So please feel free to join us and chat about OpenLP, development, testing, life in general, and almost anything else.

Sign up to Launchpad
If you don't yet have a Launchpad username, you'll need to sign up for one. Join the OpenLP Development team, which has a mailing list attached to it, and you will be subscribed to it automatically. Important matters should be discussed on the mailing list.

The old mailing lists on SourceForge.net have been discontinued.

Nightly builds
There are regular nightly builds which you can use for testing. These are found on the OpenLP download page.

Development setup
For the more adventurous, you can run OpenLP 2.0 from the source code. You'll need to install Python 3, Qt4, and the PyQt4 Python bindings for Qt4. You'll also need the Bazaar client in order to check out the latest code. Read through more detailed instructions on the Linux, Mac OS X and Windows pages.

Get the code (for the development setup)
If you want to be able to pull OpenLP directly from the source code repository, you'll want to follow the Launchpad instructions below. If not, you can always get a copy of the latest code at http://openlp.org/files/latest.tar.gz.

Sign up (optional)
If you don't yet have a Launchpad username, you'll need to sign up for one. Don't forget to upload your public SSH key, as shown on the pages for Windows and Linux/Mac OS X.

Check out the latest code
openlp.org uses the Bazaar DVCS (read more about Bazaar) and the main branch is hosted at Launchpad.net. Do the following to check out the trunk:


 * 1) Identify yourself to Bazaar: $ bzr whoami "Raoul Snyman "
 * 2) Log in to Launchpad: $ bzr launchpad-login raoul-snyman
 * 3) Create a shared repository: $ bzr init-repo --2a ~/Projects/openlp
 * 4) Checkout the latest code: $ bzr checkout lp:openlp ~/Projects/openlp/trunk

Run OpenLP!
Finally, you'll want to run OpenLP. Open your command line and navigate to where you checked out OpenLP, and then run the openlp.py file:

Linux/Mac OS X

./openlp.py

Windows

C:\openlp> C:\Python33\python.exe openlp.py