Testing:Getting Started

From OpenLP
Jump to: navigation, search

This page is outdated and needs to be updated

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

Sign up to Launchpad (mandatory)

Launchpad logo.png

If you don't yet have a Launchpad username, you'll need to sign up for one. In order to commit code back into the main branch, you'll need to have a Launchpad username, and will need to apply to be added to the OpenLP Development team on Launchpad. Once you're on Launchpad, you can propose a merge.

Don't forget to upload your public SSH key, as shown on the pages for Windows and Linux/Mac OS X.

Sign up to the Developer Mailing List (mandatory)

The OpenLP development team uses a mailing list for all important communication. To sign up for the mailing list, go to https://lists.openlp.io/mailman/listinfo/openlp-dev

Hang out in the IRC channel with us (highly recommended)

Irc.png

Almost all of the developers are active in the OpenLP IRC channel. We discuss a lot of things in IRC that don't necessarily make it on to the mailing list or the wiki, so it is advantageous to hang out in IRC.

Network: Freenode (chat.freenode.net)
Channel: #openlp

A few notes, with regards to IRC:

  • Most of the developers live in timezones close to UTC (GMT), and as such will not be around in the evening hours of the USA.
  • Don't private message people, this is regarded as rude
  • Don't use CAPITAL LETTERS, this is also regarded as rude
  • Multiple exclamations!!! or question marks??? are unnecessary
  • IRC is not private, don't post any information you don't want the general public reading
  • Use LodgeIt! for code, or anything else you want to paste which is longer than 3 lines
  • Relax, we're a friendly bunch and like to joke around. Don't take us too seriously.

The active core developers are superfly, TRB143 and tgc. Some of the other active developers are joq, samuel_m and springermac. Unit193 is often around at times when others aren't, and can usually point you in the right direction.

Most of the developers are in timezones from UTC to UTC+2.

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 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.

Check out the latest code

Python code.png

OpenLP uses the Bazaar DVCS (read more about Bazaar) and the main branch is hosted at Launchpad.net. Do the following to set up your local branch:

  1. Identify yourself to Bazaar:
    $ bzr whoami "Raoul Snyman <raoulsnyman@example.com>"
  2. Log in to Launchpad:
    $ bzr launchpad-login raoul-snyman
  3. Create a shared repository:
    $ bzr init-repo ~/openlp
  4. Checkout the latest code:
    $ bzr checkout lp:openlp ~/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

python openlp.py