VideoPsalm

This tutorial describes how a contributor can translate the VideoPsalm application into a new language.
It consists into translating the texts, buttons, tool-tips, messages, etc. that appear in the VideoPsalm dialogs.

Before you start to help, please use the contact form or let us know by email.
This will prevent potential duplicated translation work.

As of 2022, VideoPsalm is available in more than 50 languages.
The available languages are displayed in the VideoPsalm option dialog:

In the "General" tab, expand the language drop-down, and select your language :

If your language is not in the list, still maybe somebody may have translated it since you installed your VideoPsalm:

1. Make sure you run the latest VideoPsalm version.
   You can download the latest version from here.
2. Check the VideoPsalm online library.
   Your language may be newly available there:

In the Import assistant dialog, select "Import a language" from the VideoPsalm online library:

The VideoPsalm online library contains the up-to-date list of languages.
It highlights new or updated languages:

If your language is not available (= you don't see it in the list), read further...

In the VideoPsalm options, in the "General" tab, click the "Translate VideoPsalm" button:

This opens the VideoPsalm integrated translation tool, from where you can change the texts that appear in the VideoPsalm menus and dialogs, or add a new language:

The label panel (1)
The label panel lists all the labels that VideoPsalm uses.
There, you can edit the labels, as you would in Excel.
By default, the "Comments" column is selected.
Comments help to know what a label is for and were it appears. (However, not all labels are commented.)

The language panel (2)
When you select a language in the language panel (2), a corresponding column appears in the label panel (1).

You need to click twice on a language to select it: the first click marks the language, and the second click selects the checkbox.
Keep the “Comments” ticked, as they will help you translate the texts.

Select 2 languages:

1. A source language, where you are most fluent with, or one that is close to your language.
The choice of the source language is critical, it can significantly speed-up your translation work.
If possible, select English, French, German, Dutch.

In this tutorial, for the source language, let's select English.

2. Select a target language. In panel (2), additionally select the language that you want to contribute for its translation.
Let's select Russian.

You now have 4 columns displayed in the label panel (1):
1. Id
2. Comments
3. The source language (English)
4. The target language (Russian)

Now is the right time to reorder the columns.
Drag & drop the "Comments" column header to get following positions:
1. Id
2. The source language (English)
3. The target language (Russian)
4. Comments

You get something like this:

If you don't need the "Comments" column, deselect it in the language panel (2) to hide it:

Use the mouse to resize the column headers:

Press the "Add..." button:

This opens the "Add languages" dialog, where you will find a lot more of the world languages:

Select a language and press "Add" to add it to VideoPsalm.

In the "Add languages" dialog, languages that are already available in VideoPsalm are grayed out, you cannot add them anymore.

If your language is not found in the list, add it manually:

In the dialog that opens, type-in your language name:

Use the name corresponding to the official language code, found here:
Official world language code lists

Collapse the integrated help panel and maximize the window, to see more columns and rows:

Since version 1.27, VideoPsalm operates with "Google Translate" to automatically translate the labels in around 120 world languages.
VideoPsalm will translate the source column (column 1) into the target column (column 2).

1. Select the empty cells to translate.
Alternatively, you can select the source cells, it doesn't matter. The selected rows are what matters.
To select a range of cells, click the first cell, then, while pressing the "Shift" keyboard key, click the last cell.
To add more cells, click on them while pressing the "Ctrl" keyboard key.

2. Right-click and select "Translate selection":

After a short moment, the Russian text fills the selected cells:

The automatic translation function uses a free service from Google.
This function requires an Internet connection.
Your free translation credit granted by Google may get used up.
If you don't have anymore credit, VideoPsalm will fail to translate the labels.
In this case, wait for an hour or two to get your credit back again.
If necessary, instead of waiting, temporarily use a VPN, for example TunnelBear.
TunnelBear has a free plan that is big enough for this and it works wonderfully.

To check your translation in its context, select your language in the “Language” panel, then click the “Apply” button.
VideoPsalm will instantly display your translated texts where they belong, in every dialog.

You can then use VideoPsalm in the language that you just translated, and test if everything displays as expected.
Repeat this until you are satisfied with the result.

Save your work by clicking the “Save” button.

When your work is complete, send us your translation by clicking the “Send” button.
Send us the relevant zipped (compressed) file, as an email attachment.
In this example, this would be the “Русский (Россия), ru-RU.zip” file (Russian):

Once we receive your language file, we make it available online for others to use.

When a new language is added to the VideoPsalm online library, all VideoPsalm users get notified, via a toast, the next time they start VideoPsalm:

When they click on the toast, VideoPsalm opens the language import assistant, where they can select the language(s) to add or update in their own VideoPsalm:

Let us know how you would like your card to appear on the contributor's page.
A picture of you or your avatar is welcomed.

Thanks in advance for your help.

Did you know that almost 2 billion people write and read from right to left?

2 000 000 000 people, that is really a lot!

If you are one of them, I am pretty sure that you are excited about VideoPsalm adjusting itself to the way you read.

This topic shows how to setup your VideoPsalm for a Right-to-left culture.
Right-to-left (RTL) layout is fully supported in VideoPsalm starting with version 1.27.

When you start VideoPsalm on an operating system configured to Arabic, it displays its menus and panels in a Right-to-left layout:

In an RTL layout, notice the Windows closing buttons, completely at the left, and the ribbon tabs, at the right.

This is how it looks when you display Bible verses in a Right-to-left layout:

You will feel at home, whatever culture you belong to.

To switch to another language, open the VideoPsalm options, and select your language in the "General" tab:

The newly selected language is applied immediately.
No restart is necessary after a language switch.

However, to get the Right-to-left layout, restart VideoPsalm:

After a restart, the layout of the VideoPsalm windows adjusts to the culture:

Here is the song verse order editor (new in version 1.27):

The stage view options:

Everything is mirrored as it should be.
In Hebrew too:

There are three ways to toggle the toolbar.

First, make sure that you are in "Edit" mode.
To go into "Edit" mode, press the "Pencil" button located to the right of the dialog.

​
​Method 2. Use the small dropdown button on the top-right, a dropdown menu will appear, choose the necessary option:

​Method 3. Use Ctl+F1 to hide or bring back the the toolbar.
​The little white arrow on the top-right does the same trick except to bring the toolbar back again.