Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
    • Switch to GitLab Next
  • Sign in / Register
wiki
wiki
  • Project overview
    • Project overview
    • Details
    • Activity
  • Issues 19
    • Issues 19
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
    • Iterations
  • Requirements
    • Requirements
    • List
  • Operations
    • Operations
    • Incidents
  • Analytics
    • Analytics
    • Insights
    • Issue
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Create a new issue
  • Issue Boards
  • openlp
  • wikiwiki
  • Wiki
    • Development
  • Getting_Started

Last edited by Daniel Martin Jan 04, 2021
Page history

Getting_Started

  • Mandatory Requirements
  • Learn How We Do Things (mandatory)
  • Get your development environment up and running

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

Mandatory Requirements

If you are interested in contributing to OpenLP at all, including just bug fixes, these are all mandatory requirements. If you just want to look at the code, it is highly recommended that you join the developers in IRC.

Learn How We Do Things (mandatory)

All open source projects have their own way of doing things, and OpenLP is no different. We have standards around naming conventions, syntax and what text in various parts of the GUI should be like. We also have our own development workflow.

Coding and String Standards

Go and read the Coding Standards and the String Standards. If your code and your strings don't conform to the standards, then your merge proposals will be rejected and you may have to rewrite your code.

Development Workflow

We have our own unique workflow in OpenLP. If you're keen to help out, you'll need to learn our development workflow.

Get your development environment up and running

OpenLP is written in Python 3 and Qt5, so you'll need to install Python 3 (3.5+), Qt5, and the PyQt5 Python bindings for Qt5. PyCharm is a great Python IDE with support for PyQt5 which many of the developers use (there is a community edition available for free). You'll also need a Git client in order to check out the latest code. Read more detailed instructions on the following pages:

  • Linux Development Environment
  • Mac OS X Development Environment
  • Windows Development Environment
Clone repository
  • Addendum
  • Brand_Guidelines
  • Classes_Plugin
  • Code Structure
  • Configuring_SSH_Keys_on_Linux_and_Mac_OS_X
  • Configuring_SSH_Keys_on_Windows
  • Creating a Study Bible for OpenLP
  • Custom Stage Views
  • Development of Icons
  • Development
    • Branching_And_Merging_Standards
    • Coding_Standards
    • Convert from Bazaar to Git
    • Core_API_Framework
    • EasySlides_ _Song_Data_Format
    • EasyWorship_ _Song_Data_Format
View All Pages