r1443

documentation/manual/source/alert.rst

@@ -0,0 +1,57 @@
+=====
+Alert
+=====
+
+From time to time it may be necessary to display a small unobtrusive message to 
+the congregation. In OpenLP this is known as an `Alert`. Examples could be a car 
+with the headlights left on, a parent needed in nursery, or anything else 
+somebody may need notified about. This is easily accomplished using the Alert, 
+which is accessible from the top Menu under :menuselection:`Tools --> Alert`.
+
+.. image:: pics/alert.png
+
+:guilabel:`Alert text:` Enter the message you want displayed in this box.
+
+:guilabel:`Parameter:` This box is used for words you want to insert into the 
+alert text.
+ 
+You will add the Parameter text into the alert text using “<>” (without 
+quotations). Anywhere in the Alert text that you add these two symbols, <> side 
+by side, will insert any text you have in the parameter box into the Alert 
+message.
+
+Examples of use
+---------------
+ 
+:guilabel:`Alert text:` The owner of the vehicle with license plate number <> 
+your lights are on.
+
+:guilabel:`Parameter:` HNN432
+
+These two settings will display like this:
+
+The owner of the vehicle with the license plate number HNN432 your lights are on.
+
+You could also reverse this example:
+
+:guilabel:`Alert text:` HNN432 <>
+
+:guilabel:`Parameter:` left their lights on.
+
+`Will display like this:` HNN432 left their lights on.
+
+If you use the same alerts on a regular basis, Save your Alert and you will have 
+access to the alert with a click of the mouse. You may also click on `New` to 
+make a new alert or `Delete` an alert you do not need.
+
+When you are ready to Display your Alert you have two options. Clicking on 
+Display will display the Alert and the Alert Message window will remain open. 
+Clicking Display & Close will display the alert and close the Alert Message 
+window. 
+
+All details of the display, font, color, size and position are adjusted from the 
+top Menu item :menuselection:`Settings --> Configure OpenLP`, Alert tab and the 
+instructions here. :doc:`configure`
+
+**Please note:** Alert Message is a Plugin that needs to be Active in the Plugin 
+List for use.

documentation/manual/source/faq.rst

@@ -0,0 +1,563 @@
+==========================
+Frequently Asked Questions
+==========================
+
+General Questions
+=================
+
+What is OpenLP?
+---------------
+
+
+OpenLP stands for "Open source Lyric Projection" and is presentation software 
+developed for Churches to provide a single easy to use interface for the 
+projection needs of a typical act of Worship. First created in 2004, it has 
+steadily grown in features and maturity such that is it now a mainstay in 
+hundreds of churches around the world. 
+
+It can hold a searchable database of song lyrics and Bible verses allowing them 
+to be projected instantly or saved in a pre-prepared order of service file. 
+Themes allow song backgrounds to be changed instantly. PowerPoint presentations, 
+videos and audio files can be run from within the program removing the need to 
+switch between different programs. Alert messages can be displayed so the 
+Nursery or Car park stewards can notify the congregation easily. Remote 
+capability allows the worship leader to change songs, or for alert messages to 
+be sent from anywhere on the network, even via a phone.
+
+Being free, this software can be installed on as many PC's as required, even on 
+the home PC's of worship leaders without additional cost. Compared to the 
+expensive site licenses or restrictions of commercial software we believe OpenLP 
+cannot be beaten for value.  Still in active development by a growing team of 
+enthusiastic developers, features are being added all the time, meaning the 
+software just improves all the time.
+
+When is the release date for OpenLP 2.0?
+----------------------------------------
+
+`It will be ready when it's ready!` We do not have fixed dates, but we have 
+set some `targets for the releases <http://wiki.openlp.org/Version_2_Milestones>`_.
+If you take part in the `development <http://wiki.openlp.org/Development:Getting_Started>`_,
+start to `test OpenLP <http://wiki.openlp.org/Testing:Getting_Started>`_ and 
+`provide feedback <http://wiki.openlp.org/Help:Contents>`_ this will speed up 
+the progress.
+
+Can I help with OpenLP?
+-----------------------
+
+OpenLP is possible because of the commitment of individuals. If you would like 
+to help there are several things that you can get involved with. Please see: 
+`Contributing <http://openlp.org/en/documentation/introduction/contributing.html>`_ 
+for more information.
+
+I use and like OpenLP and would like to tell others online. Where can I do this?
+--------------------------------------------------------------------------------
+
+A variety of places!
+
+* Are you on facebook? Then `become a fan <http://www.facebook.com/openlp>`_
+* Are you on twitter? Then `follow openlp <http://twitter.com/openlp>`_, and retweet the announcements.
+* Give us a thumbs up on the `SourceForge project page <http://www.sourceforge.net/projects/openlp>`_ 
+* If you have a website or blog, then link to our site http://www.openlp.org with a few words saying what the software is and why you like it.
+* Add a placemark on our `Worldwide Usage map <http://maps.google.com/maps/ms?ie=UTF8&source=embed&msa=0&msid=113314234297482809599.00047e88b1985e07ad495&ll=13.923404,0&spn=155.179835,316.054688&z=2>`_, so others in your locality can see someone close by is using it.
+* If you are a member of any Christian Forums or websites, and their rules allow it, then perhaps review the software or ask others to review it.
+
+What operating systems will OpenLP 2.0 support?
+===============================================
+
+OpenLP 2.0 is designed to be cross platform. Currently it has been known to run 
+on Windows (XP, Vista, 7), Linux (Ubuntu/Kubuntu, Fedora), FreeBSD & Mac OSX. 
+`Please let us know <http://wiki.openlp.org/Help:Contents>`_ if you've 
+successfully run it on something else.
+
+Which programming language is 2.0 developed in?
+-----------------------------------------------
+
+OpenLP 2.0 is written in `Python <http://www.python.org>`_ and uses the 
+`Qt4 toolkit <http://qt.nokia.com>`_. Both are cross-platform which allows the 
+software to run on different types of machine and so allow more people access to 
+free worship software. Python is one of the easier programming languages to 
+learn, so this helps us develop and `find bugs <http://wiki.openlp.org/Bug#Something_has_gone_wrong.2C_what_should_I_do_to_help_get_it_fixed.3F>`_ 
+quicker, and also allows more developers to contribute with the project.
+
+Which written languages does OpenLP support?
+--------------------------------------------
+
+The beta now has support for a few languages which can be seen on the 
+:menuselection:`Settings -->Translate` menu. However some of these translations 
+are incomplete. If you would like to help complete or start to translate OpenLP 
+into your language then see the `Getting started page <http://wiki.openlp.org/Translation:Getting_Started>`_. 
+
+What is a beta release?
+-----------------------
+
+A beta release is a release which is almost feature complete and is fairly 
+stable. However there may still be a few `features <http://wiki.openlp.org/Version_2_Features>`_ 
+to complete, and `bugs <https://bugs.launchpad.net/openlp>`_ we've not yet fixed. 
+It is used by several people without serious problems. However there is a small 
+possibility that it could still crash occasionally or do unexpected things. It 
+is intended for those who want the latest version, and are prepared to give the 
+program a good test before using it in a live situation to ensure they won't 
+encounter any unexpected problems. If you want to have a look at the latest beta 
+release then just `download it <http://openlp.org/en/download.html>`_.
+
+Should I use this beta release at Church in my Sunday services?
+---------------------------------------------------------------
+
+As long as you have taken the time to run through your service a couple of times 
+on your target machine, the answer to this question is **yes**. The OpenLP 
+team believes that OpenLP 2.0 beta 1 is stable enough to be used in Sunday 
+services. As of beta 1, there are a good number of churches already using 
+version 2.0 successfully. The OpenLP team works hard to make sure each release 
+is solid, but cannot yet guarantee that everything works perfectly, or even 
+correctly.
+
+If however your congregation is made up of 85 year old women who snarl when you 
+suggest replacing the gas lamps with electric light bulbs and consider the pipe 
+organ too loud and modern, then we recommend sticking with version 1.2 for now.
+
+As of beta 1, version 1.2 of OpenLP is "put out to pasture" - no more 
+development or even bugfixes will be performed on that version.
+
+Upgrading
+=========
+
+Does 2.0 replace 1.2, or can they be run side by side?
+------------------------------------------------------
+
+It is perfectly safe to install 2.0 on a system with 1.2. Both versions are 
+installed in separate places, so you can still go back to 1.2. You can even run 
+them at the same time!
+
+2.0 stores its data in a separate folder to 1.2, so your data is perfectly safe, 
+and whatever you do in 2.0 will not damage 1.2
+
+Are 1.2 and 2.0 compatible?
+---------------------------
+
+No. However imports exist to transfer your data to the new version.
+
+I have a computer that is quite old, should I upgrade?
+------------------------------------------------------
+
+2.0 does require significantly more resources than v1.2. Therefore if your 
+computer does not have much memory you may find 2.0 will struggle, `especially` 
+when changing between slides.
+
+Why can I not see my 1.2 songs, bibles and themes in 2.0?
+---------------------------------------------------------
+
+This is an beta release, which means it is not finished and one of the things we 
+haven't completely finished yet is importing 1.2 data automatically. We plan to 
+do this `Version 1.9.6 (beta 2) <http://wiki.openlp.org/Version_2_Milestones#Version_1.9.6_.28beta_2.29>`_.
+
+How do I transfer my 1.2 song database?
+---------------------------------------
+
+In OpenLP v2, go to the :menuselection:`File --> Import --> Song` menu.
+In the Wizard that appears, click Next and choose "openlp.org v1.x" from the 
+Format list. Click the search button on the Filename prompt, and at the bottom 
+of the dialog, copy the following into the File name prompt::
+
+  %ALLUSERSPROFILE%\Application Data\openlp.org\Data\songs.olp
+
+`(This must be in the popup file chooser dialog. Don't enter it directly into 
+the wizard).`
+
+Click Open, then in the wizard just click Next and wait for the import to complete.
+
+How do I transfer my 1.2 Bibles?
+--------------------------------
+
+In OpenLP v2, go to the :menuselection:`File --> Import --> Bible` menu.
+In the Wizard that appears, click Next and choose "openlp.org v1.x" from the 
+Format list.
+Click the search button on the Filename prompt, and at the bottom of the dialog, 
+copy the following into the File name prompt::
+
+  %ALLUSERSPROFILE%\Application Data\openlp.org\Data\Bibles
+
+`(This must be in the popup file chooser dialog. Don't enter it directly into 
+the wizard).`
+
+Choose the Bible, Click Open, then in the wizard just click Next, enter the 
+License details, and wait for the import to complete.
+
+How do I transfer my 1.2 Themes?
+--------------------------------
+
+In openlp.org v1, export each theme by selecting it in the Theme Manager, and 
+then clicking the picture of a blue folder with red arrow on the Theme Managers 
+toolbox. This theme file can then be imported into V2 using the 
+:menuselection:`File --> Import --> Theme` menu.
+
+I can't get my 2.0 theme to look the same as 1.2
+------------------------------------------------
+
+OpenLP 2.0 is a complete rewrite using a completely different programming 
+language so it would work on different types of system. There are differences in 
+how the old and new languages draw text on the screen, and therefore it is 
+unlikely you'll get an exact match.
+
+Using OpenLP
+============
+
+Is there a manual or any documentation for 2.0?
+-----------------------------------------------
+
+Some folks are working on a brand new manual for OpenLP 2.0. You can find the 
+latest version of this manual at http://manual.openlp.org. If you need help, 
+use the live chat feature or ask in the forums. If you would like to help write 
+the manual, please let us know - we are always happy for new volunteers to join 
+the team and contribute to the project.
+
+I've started OpenLP, but I can't see the songs or bibles section in the Media Manager
+-------------------------------------------------------------------------------------
+
+When you installed OpenLP, the first time wizard would have asked which plugins 
+you wanted, and songs and bibles should have been selected. If for some reason 
+they were not, then you will need to activate them yourself. See 
+`How do I activate / deactivate a plugin <http://wiki.openlp.org/Bug#How_do_I_activate_.2F_deactivate_a_plugin.3F>`_ 
+for instructions.
+
+How do I activate / deactivate a plugin?
+----------------------------------------
+
+Plugins can be turned on and off from the Plugin List Screen. Select the plugin 
+you wish to start/stop and change it's status. You should not need to restart 
+OpenLP.
+
+What are these plugins that I keep seeing mentioned?
+----------------------------------------------------
+
+The plugins allow OpenLP to be extend easily.  A number have been written 
+(Songs, Bibles, Presentations) etc but it is possible for the application to be 
+extended with functionality only you require.  If this is the case then go for 
+it but lets us know as we can help and it may be something someone else wants.
+
+How do I enable PowerPoint/Impress/PowerPoint Viewer?
+-----------------------------------------------------
+
+First of all ensure that the presentation plugin is enabled (see above).
+Then to enable a presentation application, go to the `Settings` dialog, switch 
+to the `Presentations` tab and check one of the enabled checkboxes. OpenLP will 
+automatically detect which of the three you have installed, and enable the 
+appropriate checkbox(es). Check the applications you require, and then restart 
+OpenLP for the change to be detected. 
+Note, PowerPoint Viewer 2010 is not yet supported, use 2003 or 2007.
+
+See also `I'm on Windows and PowerPoint is installed, but it doesn't appear as an option <http://wiki.openlp.org/OpenLP_2_Introduction_and_FAQ#I.27m_on_Windows_and_PowerPoint_is_installed.2C_but_it_doesn.27t_appear_as_an_option>`_
+and `Why is there no presentations plugin available on OS X? <http://wiki.openlp.org/OpenLP_2_Introduction_and_FAQ#Why_is_there_no_presentations_plugin_available_on_OS_X.3F>`_
+
+Why is there no presentations plugin available on OS X?
+-------------------------------------------------------
+
+Currently the presentations plugin is not bundled with OpenLP on OS X. The 
+reason for that is that the OpenOffice.org version on Mac OS X does not contain 
+the (more exact: does only contain a broken) interoperability component (the so 
+called pyuno bridge) which could be used by OpenLP. As soon as the 
+interoperability component works on OS X we can re-enable the plugin and bundle 
+it. We are really sorry for that.
+
+Is it possible to get Bible x? How?
+-----------------------------------
+
+The Bible plugin has a much improved `Import Wizard` which can import Bibles 
+from a variety of sources. The following sources are supported:
+
+* CSV (in the same format as `openlp.org 1.x <http://www.openlp.org/en/documentation/importing_exporting_data/bibles/importing_comma_delimited_files.html>`_)
+
+* OSIS (export from the `Sword Project <http://www.crosswire.org/sword/software/>`_ using the mod2osis tool)
+
+ * After using the Sword software Media Manager to download the required bible.
+
+ * From the command line (works on Windows and Linux):<br /><code>modernist <name>  > name.osis</code><br />`Note the <name> is case sensitive on all environments and should be the name of your bible, e.g. ESV.`
+
+ * The Bible import wizard will the read name.osis file and import your bible.
+
+* OpenSong
+
+ * OpenSong have a good selection of Bibles on their `download page <http://www.opensong.org/d/downloads#bible_translations>`_
+
+* Web Download 
+
+ * `Crosswalk <http://biblestudy.crosswalk.com/bibles/>`_
+
+ * `BibleGateway <http://www.biblegateway.com/versions/>`_
+
+ * `BibleServer <http://www.bibleserver.com>`_
+
+Why do my Bible verses take a long time to load?
+------------------------------------------------
+
+In order to better conform to copyright law, the Web Download Bibles are not 
+downloaded when you import them, but on the fly as you search for them. As a 
+result, the search takes a little longer if you need to download those 
+particular verses. Having said that, the Web Download Bibles cache downloaded 
+verses so that you don't need to download them again.
+
+My Bible is on the Web Download sites, but my Church isn't on the internet. What options do I have?
+---------------------------------------------------------------------------------------------------
+
+When you create and save a service, all the items in the service are saved with 
+it. That means any images, presentations, songs and media items are saved. This 
+is also true for bibles. What this means is you can create the service on your 
+home computer, insert a bible passage from the web, save it and then open the 
+service using your church computer and voila, the bible passage should be there! 
+Note this can also be done with songs, etc!
+
+(Advanced) Where do I find the configuration file?
+==================================================
+
+Linux, FreeBSD & PC-BSD
+-----------------------
+
+If your distribution supports the XDG standard, you'll find OpenLP's 
+configuration file in::
+
+ /home/<user>/.config/OpenLP/OpenLP.conf
+
+If that file and/or directory does not exist, look for::
+
+ /home/<user>/.openlp/openlp.conf
+
+OS X
+----
+
+You'll find your configuration file here::
+
+ /Users/<user>/Library/Preferences/com.openlp.OpenLP.plist
+ /Users/<user>/Library/Preferences/org.openlp.OpenLP.plist
+
+Windows
+-------
+
+On Windows, OpenLP does not use a configuration file, it uses the Windows 
+registry. You can find the settings here::
+
+ HKEY_CURRENT_USER\Software\OpenLP\OpenLP
+
+Troubleshooting
+===============
+
+Something has gone wrong, what should I do to help get it fixed?
+----------------------------------------------------------------
+
+If you have found an error in the program (what we call a bug) you should report 
+this to us so that OpenLP can be improved. Before reporting any bugs please 
+first make sure that there isn't already a bug report about your problem:
+
+#. Check the `Launchpad bug list <https://bugs.launchpad.net/openlp>`_
+#. `OpenLP support System <http://www.support.openlp.org/projects/openlp>`_
+#. Check the `bug reports <http://openlp.org/en/forums/openlp_20/bug_reports.html>`_ forum
+
+If there **is already a bug report**, you may be able to help by providing 
+further information. However, **if no one else has reported** it yet, then 
+please post a new bug report.
+
+#. The **preferred place** for reporting bugs is the `bugs list <https://bugs.launchpad.net/openlp>`_ on Launchpad.
+#. Alternatively, if you don't have a Launchpad account and don't want to sign up for one, you can post in the `bug reports forum <http://openlp.org/en/forums/openlp_20/bug_reports.html>`_.
+#. If none of these ways suits you, you can send an email to bugs (at) openlp.org.
+
+What information should I include in a bug report?
+==================================================
+
+* Operating System
+ 
+ * Version
+ * Distribution - Ubuntu, Fedora, etc (if you're using Linux)
+ * Edition \- Home, Basic, Business, etc (if you're using Windows)
+
+* Version of OpenLP (:menuselection:`Help --> About`)
+* The exact steps to take in order to reproduce the error
+* Version of MS Office or OpenOffice (if you're using the song imports or the presentation plugin)
+* What Bible translation and type you are importing (if you're using the Bible importer)
+* `Any` other information that might remotely be related or useful.
+
+The more information you give us, the better we can help you.
+
+I've been asked to email a debug log, where do I find this?
+-----------------------------------------------------------
+
+We may need a debug log to help pin-point the issue. A new log file is created 
+each time you start OpenLP so copy the file before you run the software a second 
+time. On Windows a Debug option is available in the start menu. On other systems, 
+you will need to run OpenLP from the command line, with the following 
+option: <code>-l debug</code>. Please note, that is a lowercase **L**.
+
+If you haven't been given a specific email address to send it to, then please do 
+not paste the log contents straight into a forum post. Instead, open the log 
+file in a text editor (such as notepad on Windows) and copy and paste the 
+contents into somewhere like `pastebin.com <http://pastebin.com>`_. Then give us 
+the link to the page that is created.
+
+Windows
+-------
+
+Find the OpenLP 2.0 folder in your Start menu. Choose the "OpenLP (Debug)" option.
+
+OpenLP will start up. Go to the :menuselection:`Tools --> Open Data Folder` menu 
+option, and an Explorer window will appear containing folders such as alerts, 
+bibles, custom etc. Keep this Explorer window open.
+
+Now repeat the steps you need to take in OpenLP to reproduce the problem you had, 
+and then close down OpenLP. 
+
+In the Explorer window you left open, navigate up one level into the openlp 
+folder. You will see the <code>openlp.log</code> file. This is the file to e-mail.
+
+Linux
+-----
+
+If you installed OpenLP from a package::
+
+ @:~$ openlp -l debug
+
+Alternately, if you're running OpenLP from source::
+
+ @:~$ ./openlp.pyw -l debug
+
+If your Linux distribution supports the XDG standard, you'll find the log in::
+
+ ~/.cache/openlp/openlp.log
+
+Otherwise, you'll find the log file in::
+
+ ~/.openlp/openlp.log
+
+Mac OS X
+--------
+
+Open Terminal.app and navigate to where you installed OpenLP, usually 
+<code>/Applications</code>::
+
+ @:~$ cd /Applications
+
+Then go into the OpenLP.app directory, down to the OpenLP executable::
+
+ @:~$ cd OpenLP.app/Contents/MacOS
+
+And then run OpenLP in debug mode::
+
+ @:~$ ./openlp -l debug
+
+Once you've done that, you need to get the log file. In your home directory, 
+open the Library directory, and the Application Support directory within that. 
+Then open the openlp directory, and you should find the openlp.log file in that 
+directory::
+
+ /Users/<username>/Library/Application Support/openlp/openlp.log
+
+I'm on Windows and PowerPoint is installed, but it doesn't appear as an option
+------------------------------------------------------------------------------
+
+Try installing the `Visual C++ Runtime Redistributable <http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en>`_.
+
+The command line shows many error messages
+------------------------------------------
+
+When running OpenLP from the command line, you might get something like this::
+
+ Logging to: /home/<User>/.config/openlp/openlp.log
+
+* WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded 
+* WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded 
+* WARNING: Phonon::createPath: Cannot connect  Phonon::MediaObject ( no objectName ) to  VideoDisplay ( no objectName ). 
+* WARNING: Phonon::createPath: Cannot connect  Phonon::MediaObject ( no objectName ) to  Phonon::AudioOutput ( no objectName ). 
+* WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded
+
+These error messages indicate that you need to install an appropriate backend 
+for Phonon.
+
+Linux/FreeBSD
+-------------
+
+If you're using Gnome, you need to install the GStreamer backend for Phonon. On 
+Ubuntu you would install the <code>phonon-backend-gstreamer</code> package::
+
+ @:~$ sudo aptitude install phonon-backend-gstreamer
+
+If you're using KDE, you need to install the Xine backend for Phonon. On Kubuntu 
+you would install the <code>phonon-backend-xine</code> package::
+
+ @:~$ sudo aptitude install phonon-backend-xine
+
+If you know which audiovisual system you're using, then install the appropriate 
+backend.
+
+phonon-backend-vlc may also be worth trying on some systems.
+
+Windows & Mac OS X
+------------------
+
+Phonon should already be set up properly. If you're still having issues, let the 
+developers know.
+
+I've upgraded from 1.9.2 to a newer version, and now OpenLP crashes at start
+----------------------------------------------------------------------------
+
+You need to upgrade your song database.
+See this `blog post <http://openlp.org/en/users/jt/blog/2010-07-20-flag_day_database_schema_changes_in_trunk_revision_956.html>`_ for information on how to do this.
+
+I've upgraded to 1.9.5, and now OpenLP has duplicates of many songs in the Media Manager
+----------------------------------------------------------------------------------------
+
+You need to run the :menuselection:`Tools --> Re-index Songs`.
+
+There are no menu icons in OpenLP
+---------------------------------
+
+This may affect (only) linux users with xfce. To solve the problem, follow the 
+description `here <https://bugs.launchpad.net/ubuntu/+source/qt4-x11/+bug/501468/comments/3>`_.
+
+JPG images don't work
+---------------------
+
+This is a known issue on some Mac OS X 10.5 systems, and has also been seen on 
+Windows XP too. The solution is to convert the image into another format such as 
+PNG.
+
+MP3's and other audio formats don't work
+----------------------------------------
+
+This is a known issue on some systems, including some XP machines, and we have 
+no solution at the moment.
+
+Videos can be slow or pixelated. Background Videos are very slow
+----------------------------------------------------------------
+
+If playing video by themselves, try selecting the 
+:menuselection:`Settings --> Configure OpenLP --> Media`, Use Phonon for Video 
+playback option. As for text over video, we have no solution for speeding these 
+up. Reducing the monitor resolution and avoiding shadows and outline text will 
+help. We are hoping a future release of the toolkit we are using (QtWebKit) will 
+help improve this, but there is no timeframe at present.
+
+Features
+========
+
+What new features will I find in v2?
+------------------------------------
+
+Since v2 was a rewrite from the ground up, you won't find a great deal of new 
+features since initially we want to ensure all the v1.2 features are included. 
+However the developers have managed to sneak a few in. Take a look at the 
+`Complete list <http://wiki.openlp.org/Version_2_Features>`_.
+
+Why hasn't popular feature request X been implemented?
+------------------------------------------------------
+
+We made a decision to first implement v1.2 features, before going wild on new 
+features. There are only a handful of developers working in their spare time. If 
+we were to try and include everything we wanted to implement, then v2 would not 
+likely ever get released.
+
+I have a great idea for a new feature, where should I suggest it?
+-----------------------------------------------------------------
+
+First of all check it isn't on the `Feature Requests <http://wiki.openlp.org/Feature_Requests>`_ 
+page. If it is, then you need to say no more, it's already been suggested! If it 
+isn't on the list, then head to the 
+`feature request forum <http://openlp.org/en/forums/openlp_20/feature_requests.html>`_ 
+and post the idea there.
+
+`Help <http://wiki.openlp.org/Help:Contents>`_

documentation/manual/source/index.rst

@@ -13,10 +13,13 @@ Contents:
 
    introduction
    glossary
+   wizard
    dualmonitors
    configure
    bibles
    themes
    mediamanager
    songs
+   alert
+   faq
    troubleshooting

documentation/manual/source/introduction.rst

@@ -5,33 +5,31 @@ Introduction
 About
 -----
 
-OpenLP is an open source lyrics projection application developed specifically
-for churches. It is licensed under the GNU Generic Public License, which means
-that it is free to use and distribute, and it stays free.
+OpenLP stands for "Open Source Lyrics Projection" and is presentation software
+developed for churches to provide a single easy to use interface for the
+projection needs of a typical worship service. First created in 2004, it has
+steadily grown in features and maturity such that is it now a mainstay in
+hundreds of churches around the world.
 
-Lyrics Projection
------------------
+OpenLP has searchable databases of songs and Bible verses allowing them to be
+projected instantly or saved in a pre-prepared order of service file. Themes
+allow for a variety of presentation options and allow you to add attractive
+visuals to enhance your presentations. PowerPoint and OpenOffice presentations,
+videos and audio files can be run from within the program removing the need to
+switch between different programs. Alert messages can be displayed so the
+nursery or car park stewards can notify the congregation easily. Remote
+capability allows the worship leader to change songs, or for alert messages to
+be sent from anywhere on the network, even via a smart phone or tablet.
 
-OpenLP's purpose is to project the lyrics of songs and Bible verses using a 
-computer and a data projector. OpenLP also has the ability to project videos, 
-images, and also play audio. OpenLP also is highly customizable providing users 
-with the ability to set up a wide variety of themes, including themes with 
-video backgrounds.
+Being free, this software can be installed on as many PCs as required, 
+including the home PCs of worship leader(s) at no additional cost. Compared to
+the expensive site licenses and restrictions of commercial software we believe 
+OpenLP is the perfect choice for quality and value. Still in active development
+by a growing team of enthusiastic developers, features are being added all the 
+time resulting in continual improvement of the software.
 
-Open Source
------------
-
-OpenLP is open source software. This means that the source code (the 
-programming instructions the developers write) is open to anyone who wants to 
-look at it. This gives you, the end user, a few freedoms.
-
-From a developer's perspective, it gives you the freedom to inspect the code 
-and make sure that it is not malicious. Also, it gives you the freedom to 
-change the code and the freedom to "fork" the project and make it your own.
-
-For end users open source software gives you the freedom to use software as 
-you wish. You are not required to pay for the software and you are free to 
-make copies and distribute it to anyone you want.
+OpenLP is licensed under the GNU Generic Public License, which means
+that it is free to use, distribute, modify, and it stays free.
 
 GNU General Public License
 --------------------------
@@ -42,5 +40,5 @@ to charge for the software, and that you have to distribute the source code as
 well.
 
 You can find a copy of the GNU General Public License from the Help menu 
-selecting about OpenLP or on-line 
-at: http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
+selecting about OpenLP or on-line at:
+`<http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt>`_.

documentation/manual/source/mediamanager.rst

@@ -16,8 +16,8 @@ this is what the `Media Manager` looks like with all the plugins enabled.
 .. image:: pics/mediamanager.png
 
 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.
+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/plugins.png
 
@@ -99,6 +99,7 @@ You will type your search query in this box for the following two searches.
 Book Chapter 
 Book Chapter-Chapter
 Book Chapter:Verse-Verse
+Book Chapter:Verse-End (this will display verses to the end of the chapter)
 Book Chapter:Verse-Verse, Verse-Verse
 Book Chapter:Verse-Verse,Chapter:Verse-Verse
 Book Chapter:Verse-Chapter:Verse

documentation/manual/source/troubleshooting.rst

@@ -0,0 +1,132 @@
+===============
+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 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 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 :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/plugins.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 themes if you need more info
+on text sizes in themes.
+
+

documentation/manual/source/wizard.rst

@@ -0,0 +1,102 @@
+================
+First Run Wizard
+================
+
+When using OpenLP for the first time, the **First Run Wizard** will help you 
+with setting up your installation. This wizard is not intended to be a 
+comprehensive setup but will help you with the basics.
+
+Select Translation
+------------------
+
+.. image:: pics/001-first-time-language.png
+
+You can choose the translation you want to use or let OpenLP 
+automatically select it based on your operating system locale. Click 
+:guilabel:`OK` to continue.
+
+The "Welcome to the First Time Wizard" dialog box will appear next. Click 
+:guilabel:`Next`.
+
+.. image:: pics/002-first-time-wizard-welcome.png
+
+Activate required Plugins
+-------------------------
+
+.. image:: pics/003-first-time-wizard-plugins.png
+
+OpenLP has several plugins to choose from. By default, all plugins are enabled, 
+except the *Remote Access* plugin. For more information on these plugins, please 
+read the :doc:`mediamanager` section in the manual. If you are not sure of which 
+plugins to enable or disable, leave the selection as is. You can easily activate 
+or deactivate plugins later, when OpenLP is running, by going to 
+:menuselection:`Settings --> Plugin List`. Click :guilabel:`Next` to continue.
+
+Sample Songs
+------------
+
+.. image:: pics/004-first-time-wizard-songs.png
+
+OpenLP provides some sample songs in a few languages for downloading and 
+importing into your new song database. This is convenient for new users who do 
+not have any songs yet. If you already have songs in your database, OpenLP will 
+simply add these sample songs to your database, leaving your existing songs 
+intact. Once you are happy with which songs you'd like, click :guilabel:`Next`.
+
+Sample Bibles
+-------------
+
+.. image:: pics/005-first-time-wizard-bibles.png
+
+There are also a number of free Bibles that you can download and install. Using 
+the check box next to each Bible, select each Bible that you would like 
+installed. If you do not wish to install any Bibles, simply leave them all 
+unchecked. Once you are happy with your selection, click :guilabel:`Next` to 
+continue.
+
+Sample Themes
+-------------
+
+.. image:: pics/006-first-time-wizard-themes.png
+
+Some sample themes are also available for download and installation into OpenLP. 
+As with the Bibles, simply check the check box next to each theme to select it. 
+If you are a new user, these themes can help you understand how themes work. If 
+you are happy with your selected themes, click :guilabel:`Next` to continue.
+
+Default Settings
+----------------
+
+.. image:: pics/007-first-time-wizard-settings.png
+
+Default Display Monitor
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Screen 2. If you are installing OpenLP but are not connected to a second output 
+at the time, you can set this up later by going to 
+:menuselection:`Settings --> Configure OpenLP`.
+
+Default Theme
+^^^^^^^^^^^^^
+
+If you have selected one or more themes on the themes page of the wizard, you 
+can select which theme you'd like to be the default theme.
+
+If you are happy with the selections you have made, click :guilabel:`Next` to 
+continue to the next page.
+
+.. image:: pics/009-first-time-wizard-progress.png
+
+Making progress.
+
+.. image:: pics/010-first-time-wizard-finished.png
+
+On the last page of the wizard, OpenLP will download the sample songs, Bibles 
+and themes, and set up OpenLP for you. Click :guilabel:`Finish` and OpenLP will 
+start.
+
+.. image:: pics/011-first-time-wizard-song-import.png
+
+The main window.
+
+.. image:: pics/012-openlp-main-window.png

openlp/core/lib/__init__.py

@@ -166,7 +166,7 @@ def build_icon(icon):
             QtGui.QIcon.Normal, QtGui.QIcon.Off)
     return button_icon
 
-def context_menu_action(base, icon, text, slot):
+def context_menu_action(base, icon, text, slot, shortcuts=None):
     """
     Utility method to help build context menus for plugins
 
@@ -186,6 +186,8 @@ def context_menu_action(base, icon, text, slot):
     if icon:
         action.setIcon(build_icon(icon))
     QtCore.QObject.connect(action, QtCore.SIGNAL(u'triggered()'), slot)
+    if shortcuts:
+        action.setShortcuts(shortcuts)
     return action
 
 def context_menu(base, icon, text):

openlp/core/lib/mediamanageritem.py

@@ -101,6 +101,7 @@ class MediaManagerItem(QtGui.QWidget):
         self.toolbar = None
         self.remoteTriggered = None
         self.singleServiceItem = True
+        self.quickPreviewAllowed = False
         self.pageLayout = QtGui.QVBoxLayout(self)
         self.pageLayout.setSpacing(0)
         self.pageLayout.setMargin(0)
@@ -266,23 +267,25 @@ class MediaManagerItem(QtGui.QWidget):
                 context_menu_action(
                     self.listView, u':/general/general_delete.png',
                     self.plugin.getString(StringContent.Delete)[u'title'],
-                    self.onDeleteClick))
+                    self.onDeleteClick, [QtCore.Qt.Key_Delete]))
             self.listView.addAction(context_menu_separator(self.listView))
         self.listView.addAction(
             context_menu_action(
                 self.listView, u':/general/general_preview.png',
                 self.plugin.getString(StringContent.Preview)[u'title'],
-                self.onPreviewClick))
+                self.onPreviewClick, [QtCore.Qt.Key_Enter]))
         self.listView.addAction(
             context_menu_action(
                 self.listView, u':/general/general_live.png',
                 self.plugin.getString(StringContent.Live)[u'title'],
-                self.onLiveClick))
+                self.onLiveClick, [QtCore.Qt.ShiftModifier + \
+                QtCore.Qt.Key_Enter, QtCore.Qt.ShiftModifier + \
+                QtCore.Qt.Key_Return]))
         self.listView.addAction(
             context_menu_action(
                 self.listView, u':/general/general_add.png',
                 self.plugin.getString(StringContent.Service)[u'title'],
-                self.onAddClick))
+                self.onAddClick, [QtCore.Qt.Key_Plus, QtCore.Qt.Key_Equal]))
         if self.addToServiceItem:
             self.listView.addAction(
                 context_menu_action(
@@ -293,6 +296,9 @@ class MediaManagerItem(QtGui.QWidget):
         QtCore.QObject.connect(self.listView,
             QtCore.SIGNAL(u'doubleClicked(QModelIndex)'),
             self.onClickPressed)
+        QtCore.QObject.connect(self.listView,
+            QtCore.SIGNAL(u'itemSelectionChanged()'),
+            self.onSelectionChange)
 
     def initialise(self):
         """
@@ -411,7 +417,16 @@ class MediaManagerItem(QtGui.QWidget):
         else:
             self.onPreviewClick()
 
-    def onPreviewClick(self):
+    def onSelectionChange(self):
+        """
+        Allows the change of current item in the list to be actioned
+        """
+        if QtCore.QSettings().value(u'advanced/single click preview',
+            QtCore.QVariant(False)).toBool() and self.quickPreviewAllowed \
+            and self.listView.selectedIndexes():
+            self.onPreviewClick(True)
+
+    def onPreviewClick(self, keepFocus=False):
         """
         Preview an item by building a service item then adding that service
         item to the preview slide controller.
@@ -426,6 +441,8 @@ class MediaManagerItem(QtGui.QWidget):
             if serviceItem:
                 serviceItem.from_plugin = True
                 self.parent.previewController.addServiceItem(serviceItem)
+                if keepFocus:
+                    self.listView.setFocus()
 
     def onLiveClick(self):
         """

openlp/core/ui/advancedtab.py

@@ -67,6 +67,10 @@ class AdvancedTab(SettingsTab):
         self.doubleClickLiveCheckBox = QtGui.QCheckBox(self.uiGroupBox)
         self.doubleClickLiveCheckBox.setObjectName(u'doubleClickLiveCheckBox')
         self.uiLayout.addRow(self.doubleClickLiveCheckBox)
+        self.singleClickPreviewCheckBox = QtGui.QCheckBox(self.uiGroupBox)
+        self.singleClickPreviewCheckBox.setObjectName(
+            u'singleClickPreviewCheckBox')
+        self.uiLayout.addRow(self.singleClickPreviewCheckBox)
         self.expandServiceItemCheckBox = QtGui.QCheckBox(self.uiGroupBox)
         self.expandServiceItemCheckBox.setObjectName(
             u'expandServiceItemCheckBox')
@@ -130,6 +134,8 @@ class AdvancedTab(SettingsTab):
             'Remember active media manager tab on startup'))
         self.doubleClickLiveCheckBox.setText(translate('OpenLP.AdvancedTab',
             'Double-click to send items straight to live'))
+        self.singleClickPreviewCheckBox.setText(translate('OpenLP.AdvancedTab',
+            'Preview items when clicked in Media Manager'))
         self.expandServiceItemCheckBox.setText(translate('OpenLP.AdvancedTab',
             'Expand new service items on creation'))
         self.enableAutoCloseCheckBox.setText(translate('OpenLP.AdvancedTab',
@@ -164,6 +170,9 @@ class AdvancedTab(SettingsTab):
         self.doubleClickLiveCheckBox.setChecked(
             settings.value(u'double click live',
             QtCore.QVariant(False)).toBool())
+        self.singleClickPreviewCheckBox.setChecked(
+            settings.value(u'single click preview',
+            QtCore.QVariant(False)).toBool())
         self.expandServiceItemCheckBox.setChecked(
             settings.value(u'expand service item',
             QtCore.QVariant(False)).toBool())
@@ -193,6 +202,8 @@ class AdvancedTab(SettingsTab):
             QtCore.QVariant(self.mediaPluginCheckBox.isChecked()))
         settings.setValue(u'double click live',
             QtCore.QVariant(self.doubleClickLiveCheckBox.isChecked()))
+        settings.setValue(u'single click preview',
+            QtCore.QVariant(self.singleClickPreviewCheckBox.isChecked()))
         settings.setValue(u'expand service item',
             QtCore.QVariant(self.expandServiceItemCheckBox.isChecked()))
         settings.setValue(u'enable exit confirmation',

openlp/core/ui/servicemanager.py

@@ -588,6 +588,21 @@ class ServiceManager(QtGui.QWidget):
                 message=translate('OpenLP.ServiceManager',
                 'File could not be opened because it is corrupt.'))
             log.exception(u'Problem loading service file %s' % fileName)
+        except zipfile.BadZipfile:
+            if os.path.getsize(fileName) == 0:
+                log.exception(u'Service file is zero sized: %s' % fileName)
+                QtGui.QMessageBox.information(self,
+                    translate('OpenLP.ServiceManager', 'Empty File'),
+                    translate('OpenLP.ServiceManager', 'This service file '
+                    'does not contain any data.'))
+            else:
+                log.exception(u'Service file is cannot be extracted as zip: '
+                    u'%s' % fileName)
+                QtGui.QMessageBox.information(self,
+                    translate('OpenLP.ServiceManager', 'Corrupt File'),
+                    translate('OpenLP.ServiceManager', 'This file is either'
+                    'corrupt or not an OpenLP 2.0 service file.'))
+            return
         finally:
             if fileTo:
                 fileTo.close()
@@ -1110,6 +1125,9 @@ class ServiceManager(QtGui.QWidget):
             -1 is passed if the value is not set
         """
         item, child = self.findServiceItem()
+        # No items in service
+        if item == -1:
+            return
         if row != -1:
             child = row
         if self.serviceItems[item][u'service_item'].is_valid:

openlp/plugins/custom/lib/mediaitem.py

@@ -46,6 +46,7 @@ class CustomMediaItem(MediaManagerItem):
         self.IconPath = u'custom/custom'
         MediaManagerItem.__init__(self, parent, self, icon)
         self.singleServiceItem = False
+        self.quickPreviewAllowed = True
         # Holds information about whether the edit is remotly triggered and
         # which Custom is required.
         self.remoteCustom = -1

openlp/plugins/images/lib/mediaitem.py

@@ -46,6 +46,7 @@ class ImageMediaItem(MediaManagerItem):
     def __init__(self, parent, plugin, icon):
         self.IconPath = u'images/image'
         MediaManagerItem.__init__(self, parent, self, icon)
+        self.quickPreviewAllowed = True
         QtCore.QObject.connect(Receiver.get_receiver(),
             QtCore.SIGNAL(u'live_theme_changed'), self.liveThemeChanged)
 

openlp/plugins/songs/forms/editsongform.py

@@ -269,6 +269,8 @@ class EditSongForm(QtGui.QDialog, Ui_EditSongDialog):
                 if index is None:
                     index = VerseType.Other
                 verse[0][u'type'] = VerseType.Tags[index]
+                if verse[0][u'label'] == u'':
+                    verse[0][u'label'] = u'1'
                 verse_def = u'%s%s' % (verse[0][u'type'], verse[0][u'label'])
                 item = QtGui.QTableWidgetItem(verse[1])
                 item.setData(QtCore.Qt.UserRole, QtCore.QVariant(verse_def))

openlp/plugins/songs/lib/mediaitem.py

@@ -73,6 +73,7 @@ class SongMediaItem(MediaManagerItem):
         self.remoteSong = -1
         self.editItem = None
         self.whitespace = re.compile(r'\W+', re.UNICODE)
+        self.quickPreviewAllowed = True
 
     def addEndHeaderBar(self):
         self.addToolbarSeparator()

resources/osx/get_version.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+import sys
+import os
+from bzrlib.branch import Branch
+ 
+def get_version(path):
+    b = Branch.open_containing(path)[0]
+    b.lock_read()
+    result = '0.0.0'
+    try:
+        # Get the branch's latest revision number.
+        revno = b.revno()
+        # Convert said revision number into a bzr revision id.
+        revision_id = b.dotted_revno_to_revision_id((revno,))
+        # Get a dict of tags, with the revision id as the key.
+        tags = b.tags.get_reverse_tag_dict()
+        # Check if the latest
+        if revision_id in tags:
+            result = tags[revision_id][0]
+        else:
+            result = '%s-bzr%s' % (sorted(b.tags.get_tag_dict().keys())[-1], revno)
+    finally:
+        b.unlock()
+        return result
+ 
+def get_path():
+    if len(sys.argv) > 1:
+        return os.path.abspath(sys.argv[1])
+    else:
+        return os.path.abspath('.')
+ 
+if __name__ == u'__main__':
+    path = get_path()
+    print get_version(path)
+

resources/osx/version.master

@@ -1 +0,0 @@
-%(openlp_full_version)s