mirror of
https://gitlab.com/openlp/documentation.git
synced 2024-08-25 08:13:41 +00:00
219 lines
9.5 KiB
ReStructuredText
219 lines
9.5 KiB
ReStructuredText
.. _troubleshooting:
|
|
|
|
===============
|
|
Troubleshooting
|
|
===============
|
|
|
|
.. _t-no-media:
|
|
|
|
I can not play videos or other media
|
|
------------------------------------
|
|
|
|
If you can not play video or audio through OpenLP, the problem is most likely
|
|
that the media players have not be properly configured. The recommended media
|
|
player for OpenLP is VLC, see the manual for :ref:`config_players` for how to
|
|
setup VLC as your default player.
|
|
|
|
If you want to use the Phonon player, but it cannot play your media files, you
|
|
can look below for how best to set it up.
|
|
|
|
Codecs
|
|
^^^^^^
|
|
|
|
You may need to install codecs for certain files to play. Most newer versions
|
|
of Windows and OS X will support most media types. Most Linux distributions
|
|
will require a little more help to get certain media types to play.
|
|
|
|
Microsoft Windows
|
|
^^^^^^^^^^^^^^^^^
|
|
|
|
Later versions of Microsoft Windows (Vista, Windows 7) generally come with
|
|
everything you need to play most media formats. If for some reason you need
|
|
additional codecs we have seen success from the `Combined Community Codec Pack
|
|
(CCCP) <http://www.cccp-project.net/>`_. You might also wish to check out the
|
|
K-Lite Codec Pack. If you are having issues, results do seem to vary with the
|
|
different options. What works for some may not for others, so some trial and
|
|
error may be required.
|
|
|
|
Mac
|
|
^^^
|
|
|
|
If you are using a Mac. You may wish to play Windows formats. flip4mac enables
|
|
you to use popular Windows formats such as .wmv on your Mac. You can get it
|
|
`from here <http://dynamic.telestream.net/downloads/download-flip4macwmv.htm>`_.
|
|
|
|
Ubuntu Linux (and variants)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
If you are using Ubuntu Linux, or one of its variants (Kubuntu, Edubuntu, etc...)
|
|
it is a fairly quick and easy process to get all the codecs you need to make
|
|
things work. You will need to install two meta-packages that contain all the
|
|
multimedia codecs that you will generally need. From the Software Center install
|
|
ubuntu-restricted-extras and Kubuntu-restricted-extras, or from the terminal::
|
|
|
|
user@linux:~ $ sudo apt-get install ubuntu-restricted-extras kubuntu-restricted-extras
|
|
|
|
**Note** if you are running Kubuntu there is no need to install the
|
|
ubuntu-restricted-extras meta-package
|
|
|
|
For more information on Ubuntu and multimedia issues please check out the
|
|
`community documentation <https://help.ubuntu.com/community/RestrictedFormats/>`_.
|
|
|
|
Arch Linux
|
|
^^^^^^^^^^
|
|
|
|
The following command provides the most complete solution for codecs on Arch
|
|
Linux::
|
|
|
|
root@linux:~ # pacman -S gstreamer0.10-{base,good,bad,ugly}-plugins gstreamer0.10-ffmpeg
|
|
|
|
If you need more help with Arch Linux and multimedia please see the `Arch Linux
|
|
documentation <https://wiki.archlinux.org/index.php/Codecs>`_.
|
|
|
|
Debian Linux
|
|
^^^^^^^^^^^^
|
|
|
|
You will need to add the Debian Multimedia Repository. So add the folowing to
|
|
/etc/apt/sources.list::
|
|
|
|
deb http://www.debian-multimedia.org testing main non-free
|
|
|
|
Then update the repository info::
|
|
|
|
root@linux:~ # apt-get update
|
|
|
|
Then install the following packages::
|
|
|
|
root@linux:~ # apt-get install gstreamer0.10-ffmpeg gstreamer0.10-lame gstreamer0.10-plugins-really-bad gstreamer0.10-plugins-bad gstreamer0.10-plugins-ugly gstreamer0.10-plugins-good gstreamer0.10-x264
|
|
|
|
Fedora Linux
|
|
^^^^^^^^^^^^
|
|
You will need to set up Fedora to play most media formats. This is accomplished
|
|
using the rpmfusion repository.
|
|
|
|
**Note** the following commands will enable a third party repository to your
|
|
system. Please check out `the RPM Fusion site <http://rpmfusion.org>`_ for more information.
|
|
|
|
To enable both the free and nonfree components for any Fedora official release
|
|
enter the following commands::
|
|
|
|
su -c 'yum localinstall --nogpgcheck http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm'
|
|
|
|
After enabling the rpmfusion repository you will want to refresh your package
|
|
list, perform any updates and search for gstreamer-good, bad, and ugly and
|
|
install.
|
|
|
|
Follow the tutorial `using the rpmfusion repository <http://www.linuxjournal.com/video/getting-mp3-support-fedora-using-rpmfusion-repositories>`_
|
|
to enable extra audio and video formats on Fedora
|
|
|
|
.. _t-no-media-items:
|
|
|
|
The Media Manager appears to be missing some features
|
|
-----------------------------------------------------
|
|
|
|
If you do not see all the features listed in the Media Manager, you may need
|
|
to enable them.
|
|
|
|
To enable the plugins navigate to :menuselection:`Settings --> Plugins` or
|
|
press :kbd:`Alt+F7`. You will want to click on the plugin to the left that you
|
|
would like to enable and select **active** from the drop down box to the right.
|
|
|
|
.. image:: pics/plugin_list_main.png
|
|
|
|
By default all plugins should be enabled during the first run wizard except the
|
|
remotes plugin, unless you specify differently.
|
|
|
|
I can not see the book, chapter, and verse when I display scripture
|
|
-------------------------------------------------------------------
|
|
|
|
The book, chapter, and verse should be displayed when you display scripture. If
|
|
you can not see this your theme probably has the text size too small for the
|
|
info to be seen. See the section of the manual on :ref:`themes` if you need more info
|
|
on text sizes in themes.
|
|
|
|
I am using PowerPoint 2010 or PowerPoint Viewer 2010 and presentations do not work
|
|
----------------------------------------------------------------------------------
|
|
|
|
Currently OpenLP does not support PowerPoint Viewer 2010. PowerPoint 2010 should
|
|
work correctly, although some users have reported problems. If you have issues
|
|
with PowerPoint 2010 or PowerPoint Viewer 2010 try the PowerPoint 2003 or 2007
|
|
Viewers. `Download the PowerPoint 2007 viewer for free
|
|
<http://www.microsoft.com/downloads/en/details.aspx?FamilyID=048dc840-14e1-467d-8dca-19d2a8fd7485&displaylang=en>`_.
|
|
|
|
I have PowerPoint installed but it does not show as a presentation option
|
|
-------------------------------------------------------------------------
|
|
|
|
Installing the `Visual C++ Runtime Redistributable. <http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en>`_
|
|
has fixed this problem according to some of our users.
|
|
|
|
I am running a Linux Distro and cannot see the menu icons
|
|
---------------------------------------------------------
|
|
|
|
This seems to be a problem with XFCE and some versions of Gnome too. To correct
|
|
this problem, open a terminal and type in the following commands::
|
|
|
|
gconftool-2 --type boolean --set /desktop/gnome/interface/buttons_have_icons true
|
|
|
|
gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true
|
|
|
|
I chose to use a web Bible but it did not download the entire Bible
|
|
-------------------------------------------------------------------
|
|
|
|
Due to copyright restrictions OpenLP cannot download an entire Bible. It can
|
|
only download the section you search for. If you do not have an internet
|
|
connection where you intend to use OpenLP you will need another scripture
|
|
source. For more information about acquiring Bibles please see the section on
|
|
the :ref:`import_bibles`.
|
|
|
|
OpenLP is using a large amount of RAM when showing a presentation
|
|
-----------------------------------------------------------------
|
|
|
|
OpenLP uses a large amount of RAM when showing a presentation due to the way it
|
|
handles presentations. OpenLP itself is unable to show those presentations or
|
|
load the presentation files, so it interacts with the presentation through
|
|
either Microsoft PowerPoint or LibreOffice Impress. In order to show the slides
|
|
in the slide controller, OpenLP requests that the presentation application
|
|
export the slides to images, and then uses those images as slides. This results
|
|
in a large amount of RAM being used, especially in presentations with more than
|
|
about 20 slides.
|
|
|
|
OpenLP is not displaying correctly, or is not on the correct screen
|
|
-------------------------------------------------------------------
|
|
|
|
Please read the documentation on :ref:`dualmonitors`. It is very important to
|
|
have dual monitors setup properly for OpenLP to function as expected.
|
|
|
|
Previews are slow to load when using a theme with an image background
|
|
---------------------------------------------------------------------
|
|
|
|
If you are using a JPG formatted image for your background try converting it
|
|
to another format. There is a notable performance difference between JPG and
|
|
a format such as PNG. Other formats work in OpenLP but PNG is the preferred
|
|
image format and yields the best performance. Images should also be sized to
|
|
the size of your output. For example, if your output screen is 1024x768 you
|
|
should size your background image to 1024x768 also. OpenLP does not scale
|
|
images.
|
|
|
|
OpenLP crashes on startup on Windows
|
|
------------------------------------
|
|
|
|
If Windows is missing a proper driver for the graphics card on the computer, it
|
|
might cause OpenLP to crash on startup, resulting in a message saying
|
|
:guilabel:`OpenLP has stopped working`. To fix this find, download and install
|
|
the newest driver for your graphics card.
|
|
|
|
I saved service-files in the servicemanager folder but now they are gone
|
|
------------------------------------------------------------------------
|
|
|
|
The `servicemanager` folder which can be found in OpenLP's data folder is used
|
|
internally by OpenLP for temporary files and anything in there can and will be
|
|
deleted by OpenLP. In general you should not modify or create files in OpenLP's
|
|
data folder unless you know what you are doing.
|
|
|
|
OpenLP freezes on Xfce4 in a dual monitor setup
|
|
-----------------------------------------------
|
|
|
|
There is an issue with the Xfce4 compositor that makes OpenLP freeze when using
|
|
a dual monitor setup. See configuration of dual monitor for :ref:`xfce4display`
|
|
for a solution.
|