View on GitHub


User documentation

Installation instructions

System requirements

Quelea should run on Windows, Linux or MacOS. The developers all use Windows in their day to day work on Quelea, so that will be the most stable platform by implication, A `deb` package is provided for debian based installs (including Ubuntu) but all other platforms, including MacOS, will require the cross platform jar installer (which will require the JRE to be installed first.)

Generally, any modern machine should be ok to run Quelea, but we would recommend at a minimum:

Realistically, any machine purchased or built in the last few years should be fine.

Windows Install

The .exe file provided on the downloads file should work with most computers, if you have any problems post on the Quelea Discourse Discuss Group found here.

For videos to work, you must have the latest version of VLC installed as well. It must be *32-bit*, even if you are running on a 64 bit machine, since the JRE bundled with Quelea is also 32 bit.

Linux Install

Quelea for Linux needs Oracle Java 8. (OpenJDK8 can also be used, but only if OpenJFX8 is also installed.)

Here’s how to install Oracle Java 8 for Ubuntu/Linux Mint systems (tested on Mint 17.1 64 bit):

From the instructions here do this in a terminal:

$ sudo add-apt-repository ppa:webupd8team/java 
$ sudo apt-get update 
$ sudo apt-get install oracle-java8-installer 

That will take a while, as the download is quite large. To verify the version of Java that your system will use:

$ java -version 

You should see something like:

java version "1.8.0_40" Java(TM) SE Runtime Environment (build 1.8.0_40-b25) 
Java HotSpot(TM) 64-Bit Server VM (build 25.40-b25, mixed mode) 

If not, you might have other versions of Java installed. To set the default, do:

$ sudo update-alternatives --config java 

For example:

There are 3 choices for the alternative java (providing /usr/bin/java).

 Selection     Path                                              Priority    Status
 0             /usr/lib/jvm/java-8-oracle/jre/bin/java           1072        auto mode
 1             /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java    1071        manual mode
 2             /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java    1069        manual mode
 * 3           /usr/lib/jvm/java-8-oracle/jre/bin/java           1072        manual mode

Press enter to keep the current choice [*], or type selection number:

Choose the number that refers to the Oracle Java. The “*” indicates the current default.