diff --git a/manual/source/pics/songimporter_zionworx.png b/manual/source/pics/songimporter_zionworx.png new file mode 100644 index 0000000..c16c023 Binary files /dev/null and b/manual/source/pics/songimporter_zionworx.png differ diff --git a/manual/source/songs.rst b/manual/source/songs.rst index 470af0c..f36eb80 100644 --- a/manual/source/songs.rst +++ b/manual/source/songs.rst @@ -25,8 +25,8 @@ software that OpenLP will convert songs from. .. image:: pics/songimporterchoices.png 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. +want to import. See the following sections for information on some of the +different formats that OpenLP will import. Importing from OpenLP Version 1 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -108,6 +108,73 @@ from CCLI SongSelect. .. _songs_create_edit: +Importing from ZionWorx +^^^^^^^^^^^^^^^^^^^^^^^ + +ZionWorx (version 2.5/2.6) stores your songs in a proprietary database format +which OpenLP is unable to access directly. Thus you will first need to convert +it to a CSV text file, which OpenLP and other tools (such as spreadsheet applications) are able to access. This can be achieved via a free 3rd-party +utility called "TurboDB Data Exchange". + +1. Locate your ZionWorx songs database. ZionWorx lets you define the location in + :guilabel:`File > Preferences`. The database folder will contain a collection + of files such as Data.tdbd and MainTable.dat + + Default location on Windows XP:: + + C:\Documents and Settings\All Users\ZionWorx\2.6\Data + + Default location on Windows Vista / Windows 7:: + + C:\ProgramData\ZionWorx\2.6\Data + +2. `Download TurboDB Data Exchange + `_ from dataWeb. The utility + will be downloaded as an archive file: + + Windows:: + + tdbdataX.zip + + Linux:: + + tdbdatax.tar.gz + +3. Extract the single executable file contained in the archive file and copy it + into your ZionWorx database folder. +4. Open a command-line: + + Windows: + + 1. Press the keyboard combination *Windows key + R* to open the + :guilabel:`Run` window. + 2. Type ``cmd`` and click :guilabel:`OK`. + 3. In the command prompt window that opens, type this command (replacing + ``database-folder`` with your actual location) and press *Enter*:: + + cd "database-folder" + + Linux: + + Open a terminal and ``cd`` to your ZionWorx database folder. + +5. Run this command at the command-line:: + + tdbdatax MainTable.dat songstable.csv -fsdf -s, -qd + + You should see some feedback indicating success, such as:: + + Batch move has moved 1223 records. + +Your ZionWorx songs database has now been converted to a CSV text file. Run the +Song Importer in OpenLP, select :guilabel:`ZionWorx (CSV)`, and locate the +``songstable.csv`` file you have just created. + +.. image:: pics/songimporter_zionworx.png + +After clicking :guilabel:`Next` your import will be complete. Then press :guilabel:`Finish` and OpenLP will be ready to use the songs that you have +imported from ZionWorx. + Creating or Editing a Song Slide ================================