Here's how to translate Subsonic to a new language. This description assumes that you're using the Windows installer version of Subsonic.
In the following,
<ROOT> refers to the directory in which you installed Subsonic
- Stop the Subsonic service if it's running.
- Unzip the zip file into a new directory called
- Find the two-letter ISO-639 code for your language – a list is available here.
For instance, Italian is assigned the code
- Add the ISO-639 code to the file
- In the same directory is the file
ResourceBundle_en.propertieswhich is the English translation. Use this (or any other file) as the basis for your translation. Better yet, use the latest version from the SVN repository.
- Create the new resource file, for instance
- Translate the text in the new file.
- If you are using a non-Latin alphabet (e.g., Cyrillic or Japanese), you have to convert the property file to ASCII before using it.
native2asciitool which is included in the Java Development Kit. For instance, if you're writing a Macedonian translation (using the Cyrillic alphabet) using UTF-16 character encoding, you must convert it as follows:
native2ascii -encoding utf-16 c:\develop\ResourceBundle_mk.properties <ROOT>/subsonic.war/WEB_INF/classes/net/sourceforge/subsonic/i18n/ResourceBundle_mk.properties
- You have to restart Subsonic for the changes to have effect.
- When you're done, send the new language file to email@example.com.
Upgrade to Subsonic Premium to enjoy these extra features:
- Apps for Android, iPhone, Windows Phone, BlackBerry, Roku and more*.
- Video streaming.
- Podcast receiver.
- Share your media on Facebook, Twitter, Google+.
- No ads in the web interface.
- Your personal server address: yourname.subsonic.org
* Some apps must be purchased separately or are ad-supported.