Winamp Translation Tool

Winamp Translation Tool is a simple tool that allows you to simplify and organize translation of Winamp interface. It is possibly to generate Winamp Language Pack and do other language related stuff.


General features

Winamp Translation Tool is a simple and intuitive application. It is designed to help Winamp translators. It is great tool for translators of Winamp interface and developers of Winamp plugins who want to localize their plug-ins.


Winamp Translation Tool allows you to create Winamp Language Pack (WLZ). Winamp Language Pack file is a normal ZIP archive with changed extension (Winamp Language Zip). WLZ file contains the language files with the .lng extension (a dll/exe file that contains only resources - you can create it using BUILD action) and other files (skins graphics files, skins XML files, syntax help file describing the ATF and others). The base language pack file can be generated using WLZ action.

All language files can be localized using the appropriate resource editor (for example, Restorator, Resource Hacker, Visual Studio, etc). XML files, txt, html can be localized using any text editor (such as Notepad++) and finally image files can be modified using a graphics editor that supports layers (Adobe Photoshop, Gimp, etc). Localized files can be added to final WLZ file using ZIPUP action.

When you translate language files you should keep in mind the following things:

  • A string id = 65535 can not be modified!
  • A string id = 65534 of the main language file (winamp.lng) must contain a valid language identifier (language code-country code, for example: for American English: en-US, for Polish: pl-PL, for German: de-DE, etc)
  • Files stored in WLZ need to be placed into the root of the archive (not in a subdirectory) unless it is for the freeform (modern skinning support) where things need to be placed in a freeform subdirectory (e.g. freeform\wasabi.xml), dll libraries files in dll subdirectory, text files in docs subdirectory, third party language files in extralng subdirectory and language files in INI format in ini subdirectory.
  • The format allows for the direct re-mapping of images in a skin based on the following stored format in the wlz freeform\<skin_name>\<original_layout_in_the_skin>. For the winamp modern skin you would have it stored like: freeform\winamp modern\window\menu.png (and so on for any other files needed)
  • When translating any areas which involve atf/query information then you need to make sure that the ATF or Query tag is preserved in english if it is a properly used tag / part of the query language. For example: ATF: '%artist%' or Query tag: 'filename BEGINS C:'.
  • It is possible that tooltips related to the main winamp preferences are able to split onto multiple lines (or clipped to a reasonable size instead of going all over and off screen in some cases). The bounding of the tooltips will happen in all cases when the max size is reached (approx 580 pixels). However if you want to force a new line in the tooltip text then you will just need to add a \r into the string at the point where you'd like the new line to start. This is a useful feature for long strings.

A necessary condition for properly working of the program is previously installed Winamp. Winamp Translation Tool allows to do four different actions.

ZIPUP: Creating custom Winamp Language Pack (WLZ)


Chosen action allows you to create custom Winamp Language Pack (WLZ) file from the passed folder with language files. You may also add other files (e.g. ATF documentation, skins languages, external plugins languages, etc...)

To create a custom Winamp Language Pack (WLZ) you need to choose specific action to perform on the first page. This page presents all available actions along with their short descriptions.

The next page shows all the necessary settings required to create the correct custom Winamp Language Pack. To create it, you should choose the right path and specify the appropriate options.

  • Winamp Language Pack input files directory
    Input files directory stores all language files needed to create Winamp Language Pack. This directory can also store other very specific subdirectories. These include:
    • dll
      This subdirectory stores all necessary libraries (dll files) that you want to include to Winamp Language Pack (WLZ) file
    • docs
      This subdirectory stores all necessary text files that you want to include to Winamp Language Pack (WLZ) file (e.g. atf.html HTML file, that describes Winamp ATF syntax, Readme.txt text file, that describes language pack, i.e. author, copyright, contact data, etc.)
    • extralng
      This subdirectory stores all necessary third party language files (.lng) that you want to include to Winamp Language Pack (WLZ) file (e.g. plugins of DrO)
    • freeform
      This subdirectory stores all necessary language files for modern skins that you want to include to Winamp Language Pack (WLZ) file
    • ini
      This subdirectory stores all necessary language files in INI format that you want to include to Winamp Language Pack (WLZ) file
  • Winamp Language Pack output file directory
    Output directory can be any local directory. Default output directory is user Desktop directory.
  • Directly choose input and output directory
    Thanks to this option you can directly choose input directory with language files and output directory for newly created Winamp Language Pack (WLZ) file.
  • Winamp Language Pack output filename
    You can specify a name for output Winamp Language Pack (WLZ) file. Default name consists of program name (winamp) and language identifier (pl-pl)
  • Update Winamp Language Pack Readme.txt text
    Thanks to this option you can update Readme.txt file with current informations (e.g. current Winamp version, current date and time, some text for user or contact data)
  • Add specific files from subfolders to Winamp Language Pack file
    Thanks to this option you can decide if you want to include to Winamp Language Pack (WLZ) file only core language files or all files (including those stored in subdirectories: dll, docs, extralng, freeform, INI)
  • Copy newly created WLZ file to Winamp Lang Directory
    Thanks to this option you can copy newly created Winamp Language Pack (WLZ) file to Winamp language directory (Lang). Thanks to this Winamp can use it if user change the language to this one.
  • Overwrite existing Winamp Language Pack file
    Thanks to this option you can overwrite existing Winamp Language Pack (WLZ) file with the same name in output directory.
  • Set newly created WLZ file as default Winamp Language Pack
    Thanks to this option you can set newly created WLZ file as default Winamp Language Pack (the file need to ne in Winamp language directory).
  • Run Winamp with default Winamp Language Pack
    Thanks to this option you can run Winamp with default Language Pack.

After selecting the appropriate directories and setting the appropriate options, the program can generate a custom Winamp Language Pack (WLZ). Program in real time shows the progress and informs about ongoing activities. Once completed, you can quit or go to the last page, which allows you to perform a number of additional actions. Among others you can open or save the generated report in TXT or HTML format (depending on settings) or open the appropriate directories.

  • Open report files directory
  • Open newly created report file in associated application
  • Open Winamp Lang directory
  • Open WLZ source directory

WLZ: Creating Winamp Language Pack (WLZ)


Chosen action allows you to create Winamp Language Pack (WLZ) file with all language files from the passed folder with Winamp files.

To create a Winamp Language Pack (WLZ) you need to choose specific action to perform on the first page. This page presents all available actions along with their short descriptions.

The next page shows all the necessary settings required to create the correct Winamp Language Pack. To create it, you should choose the right path and specify the appropriate options.

  • Winamp Language Pack input files directory
    Input directory is directory that stores the newest Winamp files. Default input directory is Winamp installation directory.
  • Parent output directory for WLZ file and Winamp language files
    Output directory can be any local directory. Default parent output directory is user Desktop directory.
  • Directly choose input files and parent output directory
    Thanks to this option you can directly choose input directory (Winamp installation directory) and parent output directory for newly created Winamp Language Pack (WLZ) file and subdirectory with all language files.
  • Output files
    • Create only WLZ file
    • Create WLZ file and all language files in subdirectory
    You may use different name for output Winamp Language Pack (WLZ) file or output Winamp Language Pack (WLZ) file and subdirectory that stores all output language files. Default name is Winamp-en-us. You may also add version information to Winamp Language Pack (WLZ) filename or subdirectory, e.g. 5.6.6.3516.
  • Compress output Winamp Language Pack (WLZ) file
    Thanks to this option you can compress output Winamp Language Pack (WLZ) file (by default Winamp Language Pack (WLZ) file is not compressed).
  • Copy newly created WLZ file to Winamp Lang directory
    Thanks to this option you can copy newly created Winamp Language Pack (WLZ) file to Winamp language directory (Lang). Thanks to this Winamp can use it if user change the language to this one.
  • Set newly created WLZ file as default Winamp Language Pack
    Thanks to this option you can set newly created WLZ file as default Winamp Language Pack (the file need to ne in Winamp language directory).
  • Overwrite existing WLZ file or directory with language files
    Thanks to this option you can overwrite existing Winamp Language Pack (WLZ) file or existing directory with language files (if Winamp Language Pack (WLZ) file or subdirectory with the same name exists and overwrite option is disabled it will not be created).

After selecting the appropriate directories and setting the appropriate options Winamp Translation Tool can generate a Winamp Language Pack (WLZ). Program in real time shows the progress and informs about ongoing activities. Once completed, you can quit or go to the last page, which allows you to perform a number of additional actions. Among others you can open or save the generated report in TXT or HTML format (depending on settings) or open the appropriate directories.

  • Open report files directory
  • Open newly created report file in associated application
  • Open Winamp Lang directory
  • Open WLZ file directory
  • Open WLZ file or Open WLZ file and other language files directory

DIFF: Searching for resource diffrences


Chosen action allows you to find differences between files. This command takes the passed Winamp folder with newest files and compare it against the passed wlz or another Winamp folder with older files.

To find resource differences you need to choose specific action to perform on the first page. This page presents all available actions along with their short descriptions.

The next page shows all the necessary settings required to find resource differences between the newest and oldest Winamp files. To do it, you should choose the right path and specify the appropriate options.

  • Input directory with newest Winamp files
    Input directory is directory that stores the newest Winamp files. Default input directory is Winamp installation directory.
  • Source Winamp Language Pack (WLZ) or directory as source of older files
    • Use Winamp Language Pack (WLZ) file as source of older files
    • Use directory as source of older files
  • Copy differential text files to output directory
    Thanks to this option you can copy newly created differential text files (that shows all differences between the newest Winamp files and older Winamp files) to specified subdirectory (you can change name of this directory - default name is DIFFS) created in parent output directory (default parent output directory is user Desktop directory).
  • Directly choose input directory, source WLZ or source directory and parent output directory
    Thanks to this option you can directly choose input directory with the newest Winamp files, source Winamp Language Pack (WLZ) file with older Winamp files or source directory with older Winamp files and parent output directory (for subdirectory with chosen name) for newly created differential text files.
  • Exclude known images (RT_BITMAP) while making differencies
    Thanks to this option you can exclude known images (RT_BITMAP resource type) while searching for resource diffrences.
  • Overwrite existing output directory with differential text files
    Thanks to this option you can overwrite existing subdirectory (in parent output directory) that stores differential text files (if subdirectory with the same name exists and overwrite option is disabled then differential text files will not be created).

After selecting the appropriate directories and setting the appropriate options Winamp Translation Tool can generate differential text files. This files shows all differences between the newest and oldest files. Program in real time shows the progress and informs about ongoing activities. Once completed, you can quit or go to the last page, which allows you to perform a number of additional actions. Among others you can open or save the generated report in TXT or HTML format (depending on settings) or open the appropriate directories.

  • Open report files directory
  • Open newly created report file in associated application
  • Open source directory with newest Winamp files
  • Open source directory with older Winamp files
  • Open output directory with differential text files

BUILD: Creating Winamp Language file


Chosen action allows you to create a language file (*.lng) from the passed file.

To create a language file (.lng) you need to choose specific action to perform on the first page. This page presents all available actions along with their short descriptions.

The next page shows all the necessary settings required to create the correct language file. To create it, you should choose the right path and specify the appropriate options.

  • Input file from which the output language file will be created
    You can choose input file from which the output language file (.lng) will be created. It can be a Dynamic-Link Library (.dll) or executable file (.exe).
  • Output language file directory
    Output directory can be any local directory. Default output directory is user Desktop directory.
  • Directly choose input file and output directory
    Thanks to this option you can directly choose input file and output directory for newly created language file.
  • Use different filename for output language file
    Thanks to this option you can use different filename for output language file. Default name is the name of input file.
  • Overwrite existing file
    Thanks to this option you can overwrite existing language file with the same name in output directory.

After selecting the appropriate directories and setting the appropriate options Winamp Translation Tool can generate language file (.lng). Program in real time shows the progress and informs about ongoing activities. Once completed, you can quit or go to the last page, which allows you to perform a number of additional actions. Among others you can open or save the generated report in TXT or HTML format (depending on settings) or open the appropriate directories.

  • Open report files directory
  • Open newly created report file in associated application
  • Open directory with input file
  • Open direcory with output language file

Winamp Translation Tool doesn't require installation (it works in portable mode). Just download the file and run it. This program is part of the Winamp Tools software, dedicated to Winamp (so it can be also installed thanks to simple and easy to use installer, written in NSIS).


In short words, program in current version:

  • Has an intuitive and simple interface
  • Has small size, is portable, compatible with Windows 7+
  • Thanks to preferences, allows you to customize it
  • Allows to generate detailed TXT/HTML reports for chosen actions
  • Is available in several languages

As mentioned above, this program supports different languages. If you want you can translate it to your language. To do this, download the Winamp Translation Tool, go to the folder "Lang" and use the "English.lng" reference file. Read carefully all notes it contains. Also, check if your language is already supported. When you finish your translation, you can send me it via e-mail.


Download

You can download Winamp Translation Tool application. Downloaded file is compressed as zip archive. When you finish downloading, you need to uncompress it (using for example free 7zip application). Then you can run it.

Winamp Translation Tool


Winamp Translation Tool 8.0

Release date: 17.07.2017
FileSize: 4,17 MiB (4372024 bytes)
License: Freeware
Requirements: Windows 7+, Winamp
SHA256: 38f6e5661453eb5c01f292c72502cf5d3ea59ec0bc9f95c87297e4199c1bebd8

  Download Winamp Translation Tool
(File downloaded: 638 times)




If for some reason you are interested in an earlier version of Winamp Translation Tool you can visit Winamp Archive page and download appropriate version.


License

Copyright © 2004-2017 Paweł Porwisz

All rights reserved

Please read the following lines carefully before using this software. If you disagree with any of the following, you are not allowed to use this software. You MUST then delete it immediately.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.