openlp/documentation
1
0
Fork 0
mirror of https://gitlab.com/openlp/documentation.git synced 2024-12-22 12:32:48 +00:00
Code Issues Projects Releases Wiki Activity

head

Browse Source
This commit is contained in:
John Cegalis 2012-06-13 06:41:43 -04:00
commit 4f00ca1147
2 changed files with 400 additions and 344 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

744
manual/source/install_linux.rst
View File

@ -1,344 +1,400 @@
Installing OpenLP on Linux Installing OpenLP on Linux
========================== ==========================
Setting up OpenLP varies by distribution. We have included documentation on Setting up OpenLP varies by distribution. We have included documentation on
popular distributions or distributions that have OpenLP available from their popular distributions or distributions that have OpenLP available from their
package managers. It should be possible to get OpenLP running on package managers. It should be possible to get OpenLP running on
nearly any Linux distribution. nearly any Linux distribution.
Ubuntu Ubuntu
^^^^^^ ----------------
Installation of OpenLP on Ubuntu can either be done through the Software Center Installation of OpenLP on Ubuntu can either be done through the Software Center
or the command line. Command line instructions will be included at the end of or the command line. Command line instructions will be included at the end of
this section on Ubuntu and its variants. this section on Ubuntu and its variants.
Open up the software center by clicking on the :guilabel:`Software Center` icon Ubuntu 12.04 or later
in the Launcher if you are using the Unity desktop, or if you are using an ^^^^^^^^^^^^^^^^^^^^^^^^^
older version of Ubuntu, or the Classic Desktop go to :menuselection:`Applications`
and select the Software Center from the bottom of the menu. You will need to If you are using Ubuntu 12.10 or a more recent version then OpenLP is
be the administrator of the system to install OpenLP and will be asked for the included in the standard distribution. If you are using Ubuntu 12.04 then
administrator password several times through this process. OpenLP has been added to the backports packages and so is available
with the appropriate setting below.
First you will need to add the OpenLP Personal Package Archive (PPA) to
your system. Go to :menuselection:`Edit --> Software Sources` Open up the software center by clicking on the :guilabel:`Software Center` icon
in the Launcher if you are using the Unity desktop, or if you are using an
.. image:: pics/1softwaresources.png older version of Ubuntu, or the Classic Desktop go to :menuselection:`Applications`
and select the Software Center from the bottom of the menu. You will need to
Click on the :menuselection:`Other Software` tab then click on the be the administrator of the system to install OpenLP and will be asked for the
:guilabel:`Add...` button to add the new software source. administrator password several times through this process.
.. image:: pics/2othersoftware.png If using Ubuntu 12.04 then when you have the Software Center running you need to
turn on support for backports. From the menu choose Edit/Software Sources and
Add the APT line:: then the "Updates" tab. Now make sure that "Unsupported Updates
(precise-backports) is ticked. Then click :guilabel:`close`.
ppa:openlp-core/release
.. image:: pics/ubuntu-backports.png
Click :guilabel:`Add Source`
Next in any of these versions simply search for OpenLP in the Software Center
.. image:: pics/3aptline.png and click :guilabel:`Install`.
You now need to restart the Software Center to refresh the package list. When .. image:: pics/4searchopenlp.png
you have the Software Center running simply search for OpenLP and click
:guilabel:`Install`. You will see the install progress as OpenLP and the dependencies required for
it to run are downloaded.
.. image:: pics/4searchopenlp.png
.. image:: pics/5installprogressubuntu.png
You will see the install progress as OpenLP and the dependencies required for
it to run are downloaded. After installation you should see that OpenLP is installed.
.. image:: pics/5installprogressubuntu.png .. image:: pics/6installcompleteubuntu.png
After installation you should see that OpenLP is installed. You can now run OpenLP by either searching for it in the *Dash*, or clicking on
the category *Media Apps* in Unity. If you are running the Classic Desktop you
.. image:: pics/6installcompleteubuntu.png will have OpenLP available by clicking
:menuselection:`Applications --> Sound and Video --> OpenLP`
You can now run OpenLP by either searching for it in the *Dash*, or clicking on
the category *Media Apps* in Unity. If you are running the Classic Desktop you Ubuntu older than 12.04
will have OpenLP available by clicking ^^^^^^^^^^^^^^^^^^^^^^^^
:menuselection:`Applications --> Sound and Video --> OpenLP`
In older versions of Ubuntu you will first need to add the
Kubuntu OpenLP Personal Package Archive (PPA) to your system.
^^^^^^^
Open up the software center using :menuselection:`Applications`
From the KickOff Menu click :guilabel:`System Settings` Then click on and select the Software Center from the bottom of the menu. You will need to
:guilabel:`Software Management`. be the administrator of the system to install OpenLP and will be asked for the
administrator password several times through this process.
.. image:: pics/kubuntusystemsettings.png
Click on settings in the left hand column. Then go to :menuselection:`Edit --> Software Sources`
.. image:: pics/kubuntugetremovesoftware.png .. image:: pics/1softwaresources.png
Click on the :guilabel:`Edit Origins` button. Click on the :menuselection:`Other Software` tab then click on the
:guilabel:`Add...` button to add the new software source.
.. image:: pics/kubuntuaddremovesettings.png
.. image:: pics/2othersoftware.png
Click on the :guilabel:`Other Software` tab.
Add the APT line::
.. image:: pics/kubuntusoftwaresources.png
ppa:openlp-core/release
Click the :guilabel:`Add` button.
Click :guilabel:`Add Source`
.. image:: pics/kubuntuothersoftware.png
.. image:: pics/3aptline.png
Type the following in the text box::
You now need to restart the Software Center to refresh the package list. When
ppa:openlp-core/release you have the Software Center running simply search for OpenLP and click
:guilabel:`Install`.
.. image:: pics/kubuntuaddapt.png
.. image:: pics/4searchopenlp.png
After clicking :guilabel:`OK` you should now see new entries for OpenLP
You will see the install progress as OpenLP and the dependencies required for
.. image:: pics/kubuntusoftwareopenlpadded.png it to run are downloaded.
Click :guilabel:`Close` when given the option to reload the software .. image:: pics/5installprogressubuntu.png
information click the :guilabel:`Reload` button.
After installation you should see that OpenLP is installed.
.. image:: pics/kubuntureloadsources.png
.. image:: pics/6installcompleteubuntu.png
Click on :guilabel:`Get and Remove Software` in the left column. Type openlp in
the search box. Next, click on :guilabel:`Find by name`. Once OpenLP is located You can now run OpenLP by either searching for it in the *Dash*, or clicking on
click on the search result and click on :guilabel:`Install`. Click the the category *Media Apps* in Unity. If you are running the Classic Desktop you
:guilabel:`Apply` button to install OpenLP will have OpenLP available by clicking
:menuselection:`Applications --> Sound and Video --> OpenLP`
.. image:: pics/kubuntuopenlpsearch.png
Kubuntu
You should now see the progress of the download. -------
.. image:: pics/kubuntudownloadprogress.png From the Kickoff Menu click :guilabel:`System Settings` Then click on
:guilabel:`Software Management`.
Once completed you may have the option to start OpenLP from the window pictured
below. If this feature is not enabled, you can start OpenLP from the KickOff .. image:: pics/kubuntusystemsettings.png
menu.
Click on settings in the left hand column.
.. image:: pics/kubuntuopenlplaunch.png
.. image:: pics/kubuntugetremovesoftware.png
Ubuntu Command Line Install
^^^^^^^^^^^^^^^^^^^^^^^^^^^ Click on the :guilabel:`Edit Origins` button.
The following install procedure should work across all Ubuntu variants. You .. image:: pics/kubuntuaddremovesettings.png
will need to add the Personal Package Archive (PPA) to Ubuntu's software
sources. From a terminal type:: Click on the :guilabel:`Other Software` tab.
user@ubuntu:~$ sudo add-apt-repository ppa:openlp-core/release .. image:: pics/kubuntusoftwaresources.png
Now you need to refresh the package list:: Click the :guilabel:`Add` button.
user@ubuntu:~$ sudo apt-get update .. image:: pics/kubuntuothersoftware.png
Install OpenLP:: Type the following in the text box::
user@ubuntu:~$ sudo apt-get install openlp ppa:openlp-core/release
OpenLP should now be available in your desktop's menu system, but if you wish .. image:: pics/kubuntuaddapt.png
to run OpenLP from the command line type::
After clicking :guilabel:`OK` you should now see new entries for OpenLP
user@ubuntu:~$ openlp
.. image:: pics/kubuntusoftwareopenlpadded.png
Fedora (GNOME)
^^^^^^^^^^^^^^ Click :guilabel:`Close` when given the option to reload the software
information click the :guilabel:`Reload` button.
**Note** When installing OpenLP you will need to have administrator privileges.
You will be asked for the administrator password to install. .. image:: pics/kubuntureloadsources.png
Installing with Fedora you will use the default Add/Remove Programs available Click on :guilabel:`Get and Remove Software` in the left column. Type openlp in
from :menuselection:`System --> Administration --> Add/Remove Programs` in the search box. Next, click on :guilabel:`Find by name`. Once OpenLP is located
Fedora 14 and below or in :menuselection:`Applications --> System Tools --> click on the search result and click on :guilabel:`Install`. Click the
Add/Remove Programs` :guilabel:`Apply` button to install OpenLP
.. image:: pics/1fedoraaddremove.png .. image:: pics/kubuntuopenlpsearch.png
Search for OpenLP in the search box You should now see the progress of the download.
.. image:: pics/2fedoraaddremove.png .. image:: pics/kubuntudownloadprogress.png
Check the check box for OpenLP then click :guilabel:`Apply` Once completed you may have the option to start OpenLP from the window pictured
below. If this feature is not enabled, you can start OpenLP from the Kickoff
.. image:: pics/3fedoraaddremove.png menu.
Click :guilabel:`Continue` to confirm installing any additional software. .. image:: pics/kubuntuopenlplaunch.png
.. image:: pics/4fedoraadditionalconfirm.png Ubuntu Command Line Install
---------------------------
You should now see the packages downloading in the lower left corner.
If you are using Ubuntu 12.10 or a more recent version then OpenLP is included
.. image:: pics/5fedoraaddremove.png in the standard distribution. To Install OpenLP open a terminal and type::
Click :guilabel:`Run` to run OpenLP now, or :guilabel:`Close` to run OpenLP user@ubuntu:~$ sudo apt-get install openlp
later.
OpenLP should now be available in your desktop's menu system, but if you wish
.. image:: pics/6fedoracomplete.png to run OpenLP from the command line type::
OpenLP will be available in :menuselection:`Applications --> Sound & Video --> OpenLP` user@ubuntu:~$ openlp
Fedora (KDE) If you are using an older Ubuntu that does not include OpenLP in the standard
^^^^^^^^^^^^ distribution then the following install procedure should work across all Ubuntu
variants. First you will need to add the Personal Package Archive (PPA) to
**Note** when installing OpenLP you will need to have administrator privileges. Ubuntu's software sources. From a terminal type::
You will be asked for the administrator password to install.
user@ubuntu:~$ sudo add-apt-repository ppa:openlp-core/release
From the KickOff open *Software Management*. Type OpenLP into the search
box. Then click :guilabel:`Find by name` or press :kbd:`Enter`. Now you need to refresh the package list::
.. image:: pics/1fedoragetremove.png user@ubuntu:~$ sudo apt-get update
Select OpenLP from the search results. Next, click :guilabel:`Apply` Install OpenLP::
.. image:: pics/2fedoragetremove.png user@ubuntu:~$ sudo apt-get install openlp
Now give permission to install other software dependencies that are needed by OpenLP should now be available in your desktop's menu system, but if you wish
clicking :guilabel:`Continue` to run OpenLP from the command line type::
.. image:: pics/3fedoraadditionalchanges.png user@ubuntu:~$ openlp
Once completed you can run OpenLP by clicking on its logo in the completed Fedora (GNOME)
install notification, or from the KickOff menu. --------------
.. image:: pics/4fedoracompleted.png **Note** When installing OpenLP you will need to have administrator privileges.
You will be asked for the administrator password to install.
Fedora Command Line Install
^^^^^^^^^^^^^^^^^^^^^^^^^^^ Installing with Fedora you will use the default Add/Remove Programs available
from :menuselection:`System --> Administration --> Add/Remove Programs` in
To install OpenLP from the command line type:: Fedora 14 and below or in :menuselection:`Applications --> System Tools -->
Add/Remove Programs`
user@fedora:~$ sudo yum install openlp
.. image:: pics/1fedoraaddremove.png
OpenLP should now be available in your desktop's menu system, but if you wish
to run OpenLP from the command line type:: Search for OpenLP in the search box
user@fedora:~$ openlp .. image:: pics/2fedoraaddremove.png
Linux Mint Check the check box for OpenLP then click :guilabel:`Apply`
^^^^^^^^^^
.. image:: pics/3fedoraaddremove.png
The following instructions are for a standard Linux Mint install. These
instructions will not work with Linux Mint Debian Edition. If your are running Click :guilabel:`Continue` to confirm installing any additional software.
Linux Mint without the standard desktop please see the :ref:`mint-command`
install instructions. .. image:: pics/4fedoraadditionalconfirm.png
The administrator password will be required several times during the You should now see the packages downloading in the lower left corner.
installation. To install OpenLP open the Software Manager from the Mint Menu.
.. image:: pics/5fedoraaddremove.png
.. image:: pics/mint1.png
Click :guilabel:`Run` to run OpenLP now, or :guilabel:`Close` to run OpenLP
The OpenLP personal package archive (PPA) will need to be added. Click on later.
:menuselection:`Edit --> Software Sources`
.. image:: pics/6fedoracomplete.png
.. image:: pics/mint2.png
OpenLP will be available in :menuselection:`Applications --> Sound & Video --> OpenLP`
Click on the :guilabel:`Other Software` tab.
Fedora (KDE)
.. image:: pics/mint3.png ------------
Click on the :guilabel:`Add...` button to add the new software source. **Note** when installing OpenLP you will need to have administrator privileges.
You will be asked for the administrator password to install.
.. image:: pics/mint4.png
From the Kickoff open *Software Management*. Type OpenLP into the search
Add the APT line:: box. Then click :guilabel:`Find by name` or press :kbd:`Enter`.
ppa:openlp-core/release .. image:: pics/1fedoragetremove.png
Click :guilabel:`Add Source`. Select OpenLP from the search results. Next, click :guilabel:`Apply`
.. image:: pics/mint5.png .. image:: pics/2fedoragetremove.png
Click :guilabel:`Reload` to reload your software sources. Now give permission to install other software dependencies that are needed by
clicking :guilabel:`Continue`
.. image:: pics/mint6.png
.. image:: pics/3fedoraadditionalchanges.png
Type OpenLP into the search box to locate the OpenLP package.
Once completed you can run OpenLP by clicking on its logo in the completed
.. image:: pics/mint7.png install notification, or from the Kickoff menu.
Click on OpenLP from the results then click :guilabel:`Install`. .. image:: pics/4fedoracompleted.png
.. image:: pics/mint8.png Fedora Command Line Install
---------------------------
After OpenLP is installed you can close the Software Manager and start OpenLP
from the *Sound and Video* section of the Mint Menu. To install OpenLP from the command line type::
.. _mint-command: user@fedora:~$ sudo yum install openlp
Linux Mint Command Line Install OpenLP should now be available in your desktop's menu system, but if you wish
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ to run OpenLP from the command line type::
You will need to add the Personal Package Archive (PPA) to Linux Mint's user@fedora:~$ openlp
software sources. From a terminal type::
Linux Mint
user@mint:~$ sudo add-apt-repository ppa:openlp-core/release ----------
Now you need to refresh the package list:: The following instructions are for a standard Linux Mint install. These
instructions will not work with Linux Mint Debian Edition. If your are running
user@mint:~$ sudo apt-get update Linux Mint without the standard desktop please see the :ref:`mint-command`
install instructions.
Install OpenLP::
The administrator password will be required several times during the
user@mint:~$ sudo apt-get install openlp installation. To install OpenLP open the Software Manager from the Mint Menu.
OpenLP should now be available in your desktop's menu system, but if you wish .. image:: pics/mint1.png
to run OpenLP from the command line type::
The OpenLP personal package archive (PPA) will need to be added. Click on
user@mint:~$ openlp :menuselection:`Edit --> Software Sources`
openSUSE .. image:: pics/mint2.png
^^^^^^^^
Click on the :guilabel:`Other Software` tab.
OpenLP is available using 1-Click Install on the openSUSE Build Service
website. Go to the `openSUSE Build Service site <http://software.opensuse.org>`_ .. image:: pics/mint3.png
and type :kbd:`openlp` into the search box.
Click on the :guilabel:`Add...` button to add the new software source.
.. image:: pics/suse1.png
.. image:: pics/mint4.png
Then click :guilabel:`1-Click Install`
Add the APT line::
.. image:: pics/suse2.png
ppa:openlp-core/release
Select :guilabel:`Open with YaST 1-Click Install` then click :guilabel:`OK`
Click :guilabel:`Add Source`.
.. image:: pics/suse3.png
.. image:: pics/mint5.png
Additional repositories may need to be enabled. This will be performed
automatically. Accept the default options by clicking :guilabel:`Next` Click :guilabel:`Reload` to reload your software sources.
.. image:: pics/suse5.png .. image:: pics/mint6.png
Confirm you want to install OpenLP and click :guilabel:`Next` Type OpenLP into the search box to locate the OpenLP package.
.. image:: pics/suse6.png .. image:: pics/mint7.png
Before the installation takes place confirm adding the repositories and Click on OpenLP from the results then click :guilabel:`Install`.
installing the software again. Click :guilabel:`Next` to continue.
.. image:: pics/mint8.png
.. image:: pics/suse7.png
After OpenLP is installed you can close the Software Manager and start OpenLP
Since this is a third party application the software key will have to be from the *Sound and Video* section of the Mint Menu.
accepted. Click :guilabel:`Trust` to accept the software key.
.. _mint-command:
.. image:: pics/suse8.png
Linux Mint Command Line Install
OpenLP will now be installed. When the install process is completed click -------------------------------
:guilabel:`Finish`.
You will need to add the Personal Package Archive (PPA) to Linux Mint's
.. image:: pics/suse9.png software sources. From a terminal type::
OpenLP will now be available for use. user@mint:~$ sudo add-apt-repository ppa:openlp-core/release
Arch Linux Now you need to refresh the package list::
^^^^^^^^^^
user@mint:~$ sudo apt-get update
OpenLP is availabe on Arch Linux through the Arch User Repository, or AUR. Info
on the AUR can be found `at the Arch wiki <https://wiki.archlinux.org/index.php/Arch_User_Repository>`_. Install OpenLP::
There are a variety of tools and methods to install from the AUR. For this user@mint:~$ sudo apt-get install openlp
example we will demonstrate using Yaourt. For more info on Yaourt please see
the `Yaourt documentation <https://wiki.archlinux.org/index.php/Yaourt>`_. OpenLP should now be available in your desktop's menu system, but if you wish
to run OpenLP from the command line type::
From a terminal type::
user@mint:~$ openlp
user@arch:~$ yaourt -S openlp
openSUSE
OpenLP should now be available in your desktop's menu system, but if you wish --------
to run OpenLP from the command line type::
OpenLP is available using 1-Click Install on the openSUSE Build Service
user@arch:~$ openlp website. Go to the `openSUSE Build Service site <http://software.opensuse.org>`_
and type :kbd:`openlp` into the search box.
.. image:: pics/suse1.png
Then click :guilabel:`1-Click Install`
.. image:: pics/suse2.png
Select :guilabel:`Open with YaST 1-Click Install` then click :guilabel:`OK`
.. image:: pics/suse3.png
Additional repositories may need to be enabled. This will be performed
automatically. Accept the default options by clicking :guilabel:`Next`
.. image:: pics/suse5.png
Confirm you want to install OpenLP and click :guilabel:`Next`
.. image:: pics/suse6.png
Before the installation takes place confirm adding the repositories and
installing the software again. Click :guilabel:`Next` to continue.
.. image:: pics/suse7.png
Since this is a third party application the software key will have to be
accepted. Click :guilabel:`Trust` to accept the software key.
.. image:: pics/suse8.png
OpenLP will now be installed. When the install process is completed click
:guilabel:`Finish`.
.. image:: pics/suse9.png
OpenLP will now be available for use.
Arch Linux
----------
OpenLP is available on Arch Linux through the Arch User Repository, or AUR. Info
on the AUR can be found `at the Arch wiki <https://wiki.archlinux.org/index.php/Arch_User_Repository>`_.
There are a variety of tools and methods to install from the AUR. For this
example we will demonstrate using Yaourt. For more info on Yaourt please see
the `Yaourt documentation <https://wiki.archlinux.org/index.php/Yaourt>`_.
From a terminal type::
user@arch:~$ yaourt -S openlp
OpenLP should now be available in your desktop's menu system, but if you wish
to run OpenLP from the command line type::
user@arch:~$ openlp

BIN
manual/source/pics/ubuntu-backports.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 57 KiB