Testing:Getting Started
From OpenLP
So you want to help out with testing, and your next question is, "How do I get started?"
Contents |
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 the mailing lists
The official point of contact for testers is the testers mailing list (subscribe). Using the list, you can keep in touch with each other, and official tester announcements will be made on this list as well.
A lot of development-specific information is discussed in the development mailing list (subscribe). This mailing list is our official development conversation area, and you're welcome to sign up here too.
Get your testing environment up and running
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 2.5 or 2.6, 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.
Launchpad
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:
- Identify yourself to Bazaar:
$ bzr whoami "Raoul Snyman <raoulsnyman@example.com>"
- Log in to Launchpad:
$ bzr launchpad-login raoul-snyman
- Create a shared repository:
$ bzr init-repo --1.6.1-rich-root ~/Projects/openlp
- 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.pyw file like so:
Linux
@:~$ python openlp.pyw
Mac OS X
@:~$ python openlp.pyw
Windows
C:\openlp> C:\Python26\python.exe openlp.pyw