IMPORTANT NOTE: The master branch on GitHub is for the stable v5.6.0 app, which is at end of life. Current work and development contributions should be made on the MaterialApp branch, also known as v6.
Contribute to the app development
If you fancy helping develop the app, the source code is available on GitHub at https://github.com/thebigg73/OpenSongTablet. You can use GitHub to contribute to the Android code, post issues, development requests, or even editing and improving the translations.
I would like to thank the following contributors who have suggested code improvements, fixes, translations, updates, changes and helped me when I didn't have a clue what was going on (most are contributors via GitHub and I've used their 'handle' to credit them). I'm sorry if I've missed anyone or if you'd rather I didn't list you here or want it shown differently - just let me know!! Most of you will know who you are already and that I appreciate your regular communications and support.
Improve the translations
OpenSongApp was originally created using an English translation, however, I have attempted to provide alternative translations with the app. These translations were originally made using Google Translate, so they aren't perfect. I would encourage you to help out with translations if you can. Read on to find out more.
Afrikaans (improved by Alistair Baty)
French (improved by Olivier Azoulay)
German (improved by Jan Meyer and Frank Berens)
Greek (improved by Aggelos)
Russian (improved by Sergey)
Serbian (improved by Ivan Djacic)
Ukrainian (improved by Tarasz)
Many thanks to those mentioned above for helping with translation improvements (and apologies to anyone I've forgotten to mention!).
How to help
The app is created using Android studio and the translations are saved as XML files. They are stored on GitHub and can be edited freely. You don't need to know any of the complicated stuff (Android programming, JAVA, Repositories, GitHub branches/masters), all you need to do is be able to understand simple xml and I'll show you how.....
Open up the OpenSong Tablet source code on GitHub (the links below takes you to the translations folders).
If you want to edit a specific language, click on the appropriate values folder (make sure you are on the MaterialApp branch):
values = English (UK)
values-af = Afrikaans
values-cz = Czech
values-de = German
values-el = Greek
values-es = Spanish
values-fr = French
values-hu = Hungarian
values-it = Italian
values-ja = Japanese
values-pl = Polish
values-pt = Portuguese
values-ru = Russian
values-sr = Serbian
values-sv = Swedish
values-uk = Ukranian
values-zh = Chinese (simplified)
Each folder has a file in it named strings.xml. These are the translation files and you can view them by clicking on the file you want. They all follow the same format. An excerpt of the English translation (values/strings.xml) looks like this:
The name part identifies the text so the app can find it. Do not change this! The bit I've highlighted in bold can be changed. If you use the app in German and think the translation of this bit of text can be improved (this is a menu item), here's how to do it-
Open the German translation (values-de/strings.xml), look for the same string name and find the line:
You can simply copy this line and email it to me, or post it on the forum with your improved translation. I'll incorporate it in the app. Or, better still register for a free GitHub account, sign in and edit the translation file directly. I will be notified of changes and will be asked to approve them (you won't break anything!). Please notice that the translation text can be placed inside quotation marks (" "), but these aren't required. Any apostrophes should be 'escaped' by placing a backslash in front of them: \' rather than '. If you see \n in a string, this simply is an instruction for the app to start the next piece of text on a new line.
Any changes made here will become active when I next update the app.
You will notice that some strings are combined. E.g. the string names "ok", "on" and "off" are sometimes added to other strings.
Viewing other translations in the app
By default OpenSongApp will display the app in your chosen location if it exists, otherwise it will default to English.
If you want to check out other translations from within the app, you can do so from the Settings > About > Language option. Just remember how to get back to your normal language - the menu item will be in the same place, but the language will have changed!