How to create WinRAR theme file
Theme file is RAR archive containing an alternative set of graphics
and winrar_theme_description.txt file.
2. Name format
Theme file must have .theme.rar extension, so its name format is:
WinRAR creates a folder for theme graphics using 'basename' name part,
so you need to select something sensible and unique as basename
to avoid overwriting already installed themes. 'Anytext' part is optional
and ignored by WinRAR. You may use it, for example, to include the version
information. Here are a couple of possible theme file names:
Snow.ver21.theme.rar - it will be installed to 'Themes\Snow' folder
Marine.theme.rar - it will be installed to 'Themes\Marine' folder
3. winrar_theme_description.txt file
Theme file must contain winrar_theme_description.txt file in
the root folder. It is a plain text ASCII file containing
the following commands:
a) 'title' command
where is a text string displayed as a theme name
in the "Options/Themes" menu. If you provide several themes
with different toolbar sizes, it may be a good idea to include
the toolbar size into the title text.
b) 'about' command
where is information to display in WinRAR "About"
dialog. For example, it can be a copyright string or theme author name.
You can use '\n' characters to split the theme description to two lines
in the desired position. Do not use more than one '\n', because "About"
dialog has enough space only for two description strings. Also do not use
too long string, otherwise it will not fit into the dialog.
about=Marine by Peter
about=© 2004 AlexDesignStudio.\nwww.AlexDesignStudio.com.
c) 'background' command
Default color to define transparent areas in toolbar bitmaps is black,
but if you wish to use the white color for this purpose, you can add:
command to winrar_theme_description.txt. This background color
is important only if your bitmaps are not 32 bit and do not have
the alpha channel.
4. Graphics files
Theme file should contain the following graphics files.
In the root archive folder:
AboutLogo.bmp - 261x49 logo in "About" dialog
DiskOff.ico - 16x16 "inactive disk" icon in the status bar
DiskOn.ico - 16x16 "active disk" icon in the status bar
DragCopy.cur - 32x32 "copy files" cursor for drag and drop
DragMove.cur - 32x32 "move files" cursor for drag and drop
DragNo.cur - 32x32 "drop prohibited" cursor for drag and drop
Estimate.bmp - 48x48 "estimate compression" image for file "Info" dialog
File.ico - 16x16 "unknown file type" icon
FolderUp.bmp - 16x16 "go one folder up" toolbar button
PasswordOff.ico - 16x16 "inactive password" icon in the status bar
PasswordOn.ico - 16x16 "active password" icon in the status bar
RAR.ico - 16x16,32x32,48x48 general RAR icon
RarSmall.bmp - 13x13 image of RAR icon for shell extension menu
REV.ico - 16x16,32x32 recovery volumes icon
Setup.ico - 16x16 setup icon for "Add and remove programs" list
SFX.ico - 16x16,32x32 or larger SFX module icon (see notes below)
SFXLogo.bmp - 93x302 SFX module logo
SortDown.bmp - 13x13 "sort down" file list column header image
SortUp.bmp - 13x13 "sort up" file list column header image
Tray.ico - 16x16 "WinRAR in the background" tray icon (16 colors only)
WizardLogo.bmp - 64x64 logo for Wizard dialogs
In the 'Toolbar' folder:
Add.bmp - "Add" toolbar button
Benchmark.bmp - "Benchmark" toolbar button
Comment.bmp - "Comment" toolbar button
Convert.bmp - "Convert" toolbar button
Delete.bmp - "Delete" toolbar button
Exit.bmp - "Exit" toolbar button
Extract.bmp - "Extract" toolbar button
ExtractTo.bmp - "Extract To" toolbar button
Find.bmp - "Find" toolbar button
Info.bmp - "Info" toolbar button
Lock.bmp - "Lock" toolbar button
Print.bmp - "Print" toolbar button
Protect.bmp - "Protect" toolbar button
Repair.bmp - "Repair" toolbar button
Report.bmp - "Report" toolbar button
SFX.bmp - "SFX" toolbar button
Test.bmp - "Test" toolbar button
View.bmp - "View" toolbar button
VirusScan.bmp - "VirusScan" toolbar button
Wizard.bmp - "Wizard" toolbar button
a) Though it is better to keep original sizes, the size of many bitmaps
can be slightly changed without hurting WinRAR look. You can check
the outcome of such change experimentally if necessary.
b) You can use any reasonable size for toolbar buttons. WinRAR will detect
c) You can use both 24-bit and 32-bit bitmaps with alpha channel for toolbar
buttons and for FolderUp button. In case of 24-bit bitmaps use
the black color to define transparent areas.
d) One theme file can include only one set of toolbar buttons. If you wish
to provide themes with buttons of different size, create several
e) Use gray RGB(192,192,192) color in SortUp.bmp and SortDown.bmp
to define transparent areas.
f) SortUp.bmp and SortDown.bmp are used only in Windows XP and older.
WinRAR uses standard Windows sort direction images in Windows Vista
g) Color depth is not limited for most icons except Tray.ico, which must be
16 colors. WinRAR uses Tray.ico only for Windows 2000,
where a usual 256 color icon is not displayed well.
h) It is allowed to omit most of graphics files. In this case WinRAR
will use the default graphics instead. The only exception is Add.bmp
file. WinRAR uses it to detect toolbar button dimensions, so it must be
Please send your questions and theme files to firstname.lastname@example.org
(Please remove x from the middle of 'rarxlab'. Sorry, spam protection).
If your theme is based on someone's else graphics, we need to have
a permission of original graphics copyright owner to use icons
in WinRAR theme. Please send to us a copy of such permission by email.
Back to the main WinRAR page