openlp/documentation/manual/source/songs.rst

233 lines
9.8 KiB
ReStructuredText
Raw Normal View History

2010-11-14 21:01:39 +00:00
=====
Songs
=====
2010-11-20 02:32:58 +00:00
Managing your songs in OpenLP is a relatively simple process. There are also
converters provided to get data from other formats into OpenLP.
Song Importer
=============
2011-03-09 18:36:20 +00:00
If you are using an earlier version of OpenLP or, come from another software
package, you may be able to convert your existing database to work in OpenLP
2011-03-09 18:36:20 +00:00
2.0. To access the Song Importer click :menuselection:`File --> Import --> Song`.
You will see the Song Importer window, then click :guilabel:`Next`.
.. image:: pics/songimporter.png
2011-03-09 18:36:20 +00:00
After choosing :guilabel:`Next` you can select from the various types of
software that OpenLP will convert songs from.
.. image:: pics/songimporterchoices.png
2011-03-09 18:36:20 +00:00
Click on the file folder icon to choose the file of the song database you
want to import. See the following sections for information on the different
formats that OpenLP will import.
Importing from OpenLP Version 1
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2011-03-09 18:36:20 +00:00
Converting from OpenLP Version 1 is a simple process. First you will
need to locate your version 1 database file.
Windows XP::
2010-11-27 14:58:27 +00:00
C:\Documents and Settings\All Users\Application Data\openlp.org\Data\songs.olp
2010-11-27 14:58:27 +00:00
Windows Vista / Windows 7::
2010-11-27 14:58:27 +00:00
C:\ProgramData\openlp.org\Data\songs.olp
2011-03-09 18:36:20 +00:00
After clicking :guilabel:`Next` your conversion will be complete.
2010-11-27 14:58:27 +00:00
.. image:: pics/finishedimport.png
2011-03-09 18:36:20 +00:00
Press :guilabel:`Finish` and you will now be ready to use your OpenLP
version 1 songs.
2010-11-27 14:58:27 +00:00
Importing from OpenSong
^^^^^^^^^^^^^^^^^^^^^^^
2011-03-09 18:36:20 +00:00
Converting from OpenSong, you will need to locate your songs database. In the
2010-11-27 14:58:27 +00:00
later versions of OpenSong you are asked to define the location of this. The
2011-03-09 18:36:20 +00:00
songs will be located in a folder named :guilabel:`Songs`. This folder will
contain files with all your songs in them, without a file extension. (file.xxx).
When you have located this folder you will need to select the songs from
2010-11-27 14:58:27 +00:00
the folder.
.. image:: pics/selectsongs.png
2011-03-09 18:36:20 +00:00
On most operating systems, to select all the songs, first select the first song
2011-03-10 19:52:09 +00:00
in the list, press the shift key, and select the last song in the list. After
this press :guilabel:`Next` and you will see that your import has been
successful.
2010-11-27 14:58:27 +00:00
.. image:: pics/finishedimport.png
2011-03-09 18:36:20 +00:00
Press :guilabel:`Finish` and OpenLP will be ready to use your songs that you
imported from OpenSong.
2010-11-27 14:58:27 +00:00
Importing from CCLI Song Select
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To import from CCLI Song Select you must be a CCLI Subscriber and also a
2011-04-01 19:16:45 +00:00
subscriber of the Song Select service. For more info check out the `CCLI website.
2011-04-01 17:25:26 +00:00
<http://www.ccli.com>`_
2010-11-27 14:58:27 +00:00
The first step for importing from CCLI Song Select is to log into your account.
Then search for your desired song. For this example we will be adding the song
"Amazing Grace".
.. image:: pics/songselectsongsearch.png
2011-03-09 18:36:20 +00:00
For the song you are searching for, select `lyrics` This will take you to a
page displaying the lyrics and copyright information for your song.
2010-11-27 14:58:27 +00:00
.. image:: pics/songselectlyrics.png
2011-03-09 18:36:20 +00:00
Next, hover over the :guilabel:`Lyrics` menu from the upper right corner.
Choose either the .txt or .usr file. You will be asked to chose a download
2010-11-27 14:58:27 +00:00
location if your browser does not automatically select that for you. Select
this file from the OpenLP import window and then click :guilabel:`Next` You can
also select multiple songs for import at once on most operating systems by
2011-03-10 19:52:09 +00:00
selecting the first item in the list then holding the shift key and select the
last item in the list. When finished, you will see that your import has
completed.
2010-11-27 14:58:27 +00:00
.. image:: pics/finishedimport.png
2011-03-09 18:36:20 +00:00
Press :guilabel:`Finish` and OpenLP will be ready to use your songs imported
2010-11-27 14:58:27 +00:00
from CCLI SongSelect.
2011-04-15 11:17:57 +00:00
Creating or editing a song slide
================================
If you want to create a new song slide or, once you have a song imported, you
2011-04-16 00:50:55 +00:00
want to edit and rearrange the Title & Lyrics, Author, Topics & Song Book,
assign a Theme, or edit Copyright Info & Comments, you will do this through the
`Song Editor`.
**Edit:** To edit an existing song you can either click on a song in the
`Media Manager` and then click the button to :guilabel:`Edit the selected song`
or right click a song from either the `Media Manager` or additionally from the
`Service Manager` and click :guilabel:`Edit item`. If you are adding a new song
click :guilabel:`Add a new Song` in the `Media Manager`.
2011-04-15 11:17:57 +00:00
.. image:: pics/song_edit_lyrics.png
2010-11-20 02:32:58 +00:00
2011-04-15 11:17:57 +00:00
**Title:** This is where you would name your song or edit a song name.
2011-04-16 00:50:55 +00:00
**Alternate title:**Alternate Title was for songs with two names
"Lord the Light" - "Shine Jesus Shine". You can also add a name in this box that
will bring up the song in Titles search. **Example:** You could use an alternate
title of "hymn" on all your hymn song titles for grouping. When you search "hymn"
it will show all the hymns that have "hymn" for the Alternate title.
2011-04-15 11:17:57 +00:00
**Lyrics:** The *Lyrics* window shows all lyrics imported or added. On the left
side of the lyrics you will see a capital letter followed by a number. A V1
would represent verse 1, C1 would be Chorus 1. You will use these letters and
numbers for the order to display the lyrics.
**Verse Order:** After you entered or edited your song, you will want OpenLP to
display the verses in the correct order you want them displayed. On the left side
of your lyrics you will see C1, V1, V2 etc. the way they were imported or added.
To put your lyrics in the correct order is as simple as typing in the
:guilabel:`Verse order box` at the bottom, the correct order you want them
displayed, with only a blank space in between each entry. The correct format will
look like this: V1 C1 V2 C1 V3 C1. If you forget to put a space in between the
order, or if you do not have the corresponding verse number, OpenLP will politely
tell you with a pop-up error message what is wrong so you can correct your
2011-04-16 00:50:55 +00:00
mistake and save it. Verse order is optional and if left blank the verses will
display in the order seen in *Lyrics*.
2011-04-15 11:17:57 +00:00
.. image:: pics/song_edit_verse_error.png
Adding or editing the lyrics
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**Add:** To Add a new verse, click on :guilabel:`Add`. The main window is where
you will type your lyrics. OpenLP is packaged with a spell checker for most
languages. If you misspell a word it will be underlined. Right click the
underlined word and left click *Spelling Suggestions* or you can ignore it and
continue typing. You also have the ability to format the font using *Formatting
Tags*. Highlight the word/words you want to format and right click the highlight.
Left click *Formatting Tags* and choose the format you want to apply to the font
and the format tags will be entered with your lyrics. These tags are not visible
when displayed. To remove the format, delete the tag on each end of the word or
sentence.
**Edit:** To edit an existing verse, click on the verse you wish to *Edit* then click on
:guilabel:`Edit`, make your changes and click :guilabel:`Save`.
**Edit All:** To edit the whole song at once, click on :guilabel:`Edit All`.
**Delete:** To delete a verse, click on the verse you want to delete and it will
highlight, click on the :guilabel:`Delete` button and it will be deleted.
**Warning:**, once you click the :guilabel:`Delete` button, you will not be
asked again, it will be deleted immediately.
.. image:: pics/song_edit_verse_type.png
**Verse type:** gives you 7 ways to classify your lyrics. Verse, Chorus, Bridge,
Pre-Chorus, Intro, Ending, Other.
If you have more than one verse, you would number them Verse 1, 2, 3 as needed.
If you find the verse has too many lines for your screen, you can edit and
shorten the verse and :guilabel:`Add` another slide.
Authors, Topics & Song Book
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Once your *Title & Lyrics* are added or edited the way you want them you must
add or enter the author or authors of the song. OpenLP requires all songs to
have an author entered. You can add a blank space for the author name.
.. image:: pics/song_edit_authors.png
**Authors:** Click the drop down arrow to view all authors or start typing a name
in the box and a list will appear. If the authors name has not been added, type
the authors name in the box and click :guilabel:`Add to Song`. The authors name
will appear below and will also be added to your database. If you accidently add
the wrong author you can click on the authors name and click :guilabel:`Remove`.
2011-04-16 08:32:30 +00:00
:guilabel:`Manage Authors, Topics, Song Books`: Clicking this button will bring
2011-04-15 11:17:57 +00:00
up your complete list of authors.
.. image:: pics/song_edit_maintenance.png
**Add:** Clicking the :guilabel:`Add` button will bring up a box where you will
add the Authors First name, Last name and Display name. Click :guilabel:`Save`
when you are finished.
.. image:: pics/song_edit_author_maintenance.png
**Edit:** The :guilabel:`Edit` button will bring up window where you can edit
the info that is already there.
**Delete:** The :guilabel:`Delete` button will remove the author you have
highlighted. Note: You cannot delete an author that is assigned to a song.
Authors names are displayed in the footer.
Theme, Copyright info & Comments
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
On this tab you can assign a *Theme* to a song, enter the *Copyright information*
and add the *CCLI number*. If you imported a song from SongSelect this
information will usually be entered.
.. image:: pics/song_edit_theme_copyright.png
**Theme:** Click the drop down arrow to display your list of themes or start
typing a theme name in the box and the list will appear. You can also create a
new theme by clicking the :guilabel:`New Theme` button.
**Copyright information:** Add or edit the copyright information in this box. If
you would like to use the © symbol click "guilabel:`©` button. This information
is displayed in the footer.
**CCLI number:** Enter the CCLI number in this box. Note: this is the CCLI number
of the song, not your contract number. This number is not displayed in the footer
**Comments:** You can add comments in this box. This information is not
dispayed in the footer.