Repository navigation
Convert WinPaletter themes between old and new formats
Tip
This guide is obsolete.
Starting with WinPaletter 1.0.7.7 and later, themes now use a JSON-based internal format. Manual conversion is rarely needed, as opening an old-format theme in WinPaletter will prompt automatic conversion.
- WinPaletter 1.0.7.7+ uses a JSON-internally formatted theme file, making it easier to code, edit, and maintain.
- Older themes (pre-1.0.7.7) can be converted to the new format using the built-in conversion tools.
- Conversion options include:
- GUI Converter
- Command Line
- Command Line with a List File
Warning
If possible, prefer updating themes directly in WinPaletter 1.0.7.7+ rather than converting older files manually.
-
Open WinPaletter and click the Converter button:
-
Open your theme file:
- Old-format files are automatically converted to the new JSON format.
- You can also convert new-format files back to the old format (not recommended).
-
Options:
- Compress contents (Recommended; for new JSON format)
- Make compatible with WinPaletter <1.0.6.9 (Not recommended)
-
Click Export to save the converted file.
-
Open Command Prompt in the folder containing
WinPaletter.exe. -
Use one of the following formats:
WinPaletter.exe /convert:"themefile_to_be_converted"|"themefile_to_be_exported"
WinPaletter.exe /convert:"themefile_to_be_converted"|"themefile_to_be_exported"|x
WinPaletter.exe /convert:"themefile_to_be_converted"|"themefile_to_be_exported"|x|y- Arguments must be quoted and separated by
|.
-
x= Compress contents (0 = no, 1 = yes) -
y= Make compatible with old WinPaletter (<1.0.6.9) (0 = no, 1 = yes)
- WinPaletter will detect the file type and perform the conversion automatically.
Warning
Manual command-line conversion is generally unnecessary with WinPaletter 1.0.7.7+.
- Create a text file using Notepad.
- Each line should specify a theme file using one of the following formats:
"themefile_to_be_converted"
"themefile_to_be_converted"|x
"themefile_to_be_converted"|x|y
- Example of a list file:
"C:\Users\Username\Desktop\theme0.wpth"
"C:\Users\Username\Desktop\theme1.wpth"
"C:\Users\Username\Desktop\theme2.wpth|0|1"
"C:\Users\Username\Desktop\theme3.wpth|1"
"C:\Users\Username\Desktop\theme4.wpth"
"C:\Users\Username\Desktop\theme5.wpth|1|1"
"C:\Users\Username\Desktop\theme6.wpth"
- Save the text file (e.g.,
themes_list.txt) and run the following command in the folder containingWinPaletter.exe:
WinPaletter.exe /convert-list:"themes_list.txt"-
WinPaletter will process each line, converting files between the old and new formats.
-
Converted files are saved in a folder named
WinPaletterConversionlocated in the same directory as the original theme files.
Warning
This list file method is only needed for batch-converting legacy themes. Modern versions of WinPaletter do not support the legacy formatting.
