openlp-core team mailing list archive

[Wesley Stout <wesleystout@xxxxxxxxx>]

Wesley Stout has proposed merging lp:~wesleystout/openlp/documentation into lp:openlp.

Requested reviews:
  OpenLP Core (openlp-core)

For more details, see:
https://code.launchpad.net/~wesleystout/openlp/documentation/+merge/55242

added a troubleshooting guide and focused on codecs, and updated a couple of screenshots
-- 
https://code.launchpad.net/~wesleystout/openlp/documentation/+merge/55242
Your team OpenLP Core is requested to review the proposed merge of lp:~wesleystout/openlp/documentation into lp:openlp.

=== modified file 'documentation/manual/source/index.rst'
--- documentation/manual/source/index.rst	2011-03-22 18:29:29 +0000
+++ documentation/manual/source/index.rst	2011-03-28 21:58:38 +0000
@@ -18,4 +18,5 @@
    bibles
    themes
    mediamanager
-   songs
\ No newline at end of file
+   songs
+   troubleshooting

=== modified file 'documentation/manual/source/pics/mediamanager.png'
Binary files documentation/manual/source/pics/mediamanager.png	2010-10-15 01:15:55 +0000 and documentation/manual/source/pics/mediamanager.png	2011-03-28 21:58:38 +0000 differ
=== added file 'documentation/manual/source/pics/phononcheckbox.png'
Binary files documentation/manual/source/pics/phononcheckbox.png	1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/phononcheckbox.png	2011-03-28 21:58:38 +0000 differ
=== modified file 'documentation/manual/source/pics/plugins.png'
Binary files documentation/manual/source/pics/plugins.png	2010-11-03 02:07:05 +0000 and documentation/manual/source/pics/plugins.png	2011-03-28 21:58:38 +0000 differ
=== added file 'documentation/manual/source/troubleshooting.rst'
--- documentation/manual/source/troubleshooting.rst	1970-01-01 00:00:00 +0000
+++ documentation/manual/source/troubleshooting.rst	2011-03-28 21:58:38 +0000
@@ -0,0 +1,117 @@
+===============
+Troubleshooting
+===============
+
+I can not play videos or other media
+====================================
+
+If you can not play video or audio through openlp, there are several areas that
+could be an issue. First thing is to make sure you can play the media file 
+through your default media player. OpenLP should be able to play any file that
+you can play through your default media player.
+
+If you can play a file through your media player but not on OpenLP it may help
+to enable Phonon for multimedia playback. Go to the OpenLP configuration
+:menuselection:`Settings --> Configure OpenLP...` and select the Media tab.
+Make sure the check box for `Use Phonon for video playback` is checked.
+
+.. image:: pics/phononcheckbox.png
+
+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 
+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
+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 at https://wiki.archlinux.org/index.php/Codecs
+
+Debian Linux
+^^^^^^^^^^^^
+
+You will need to add the Debian Multimedia Repository. So to /etc/apt/sources.list::
+
+  deb http://www.debian-multimedia.org testing main non-free
+
+Then install the following packages::
+
+  root@linux:~ # apt-get install gstreamer0.10-ffmpeg gstreamer0.10-ffmpeg-dbg 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 relatively
+simple using the rpmfusion repository. 
+
+**Note** the following commands will enable a third party repository to your 
+system. Please check out 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.
+
+Here is a good tutorial video on the rpmfusion repository 
+http://www.linuxjournal.com/video/getting-mp3-support-fedora-using-rpmfusion-repositories
+
+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 `F7`. You will want to click on the plugin to the left that you want to 
+enable and select **active** from the drop down box to the right.
+
+.. image:: pics/plugins.png
+
+By default all plugins should be enabled during the first run wizard except the
+remotes plugin, unless you specify differently.