MediaMonkey Wiki - User contributions [en]

Skins for MediaMonkey v3.0 and higher

2008-06-12T16:23:57Z

Morten: /* iTunes 7 */

[[Skinning|''Go back to the '''main''' skinning page'']]

Listed Below are some skins for MediaMonkey v3.x. To install:
#Download the .wsz / .msz / .mmip file (You may need to right click and use the "Save link as" or "Save target as" option in your internet browser).
##For .wsz/.msz files copy and save it to the MediaMonkey Skins sub-directory (usually C:\Program Files\MediaMonkey\skins\).
##For .mmip files, just double-click the file and it will automatically install.
:::('''Special note for users of Internet Explorer''': Internet Explorer may automatically change the file extension of your skin file to .zip. If this occurs, manually change the extension of the file back to .mmip or try downloading the file with a download manager or another browser such as [http://www.firefox.com Firefox] or [http://www.opera.com Opera].
#Restart MediaMonkey.
#Go to Tools | Options | Appearance | Skins and select whatever skin you wish to use.

'''Default skin now is Morten's [[Glided Skin]]; other skins included in the install package are Blue Glass and Casino Orange.'''

==Blake's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blake's WMP11 look-a-like]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Green Version:''' [http://www.mediafire.com/?awwntvwbhti G-Monkey11]

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

===MiPod===
[[Image:Ipodfull.PNG#file|right|thumb|300px|Blake's iPod inspired skin]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-04-05

'''Current version:''' [http://www.mediafire.com/?82kmnqki0n4 Download ]

<br clear="all" />

==DreadM's skins==

===Eclipse===

'''Author:''' [[User:DreadM|DreadM]]

'''First released:''' 2008-03-24

'''Current version:''' [http://www.mediafire.com/?4n3u4xnb4md Download #1 ] (Eclipse v 1.4.2) 2008-06-01

'''SmallPlayer version:''' [http://www.mediafire.com/?yvonoq9cynm Download #2 ] (Eclipse v 1.4.2 SmallPlayer) 2008-06-01

'''SlimPlayer version:''' [http://www.mediafire.com/?diynzwyjb0e Download #3 ] (Eclipse v 1.4.2 SlimPlayer) 2008-06-01

'''Eclipse Iconset:'''[http://www.mediafire.com/?dtgemjinpax Download #4 ] (Eclipse Iconset v 0.1) 2008-04-25

'''Notes:''' New version: Eclipse v1.4 with new players and iconset(floatplayers looks like mainplayers)
[[Image:Eclipse_v_1.4..jpg |right|thumb|300px|Eclipse Theme]]
[[Image:Eclipse_v1.4_news2.png |left|thumb|300px|Eclipse Player]]
[[Image:MicroPlayer.png |center|thumb|150px|New Microplayer]]

<br clear="all" />

===Sansa===

'''Author:''' [[User:DreadM|DreadM]]

'''First released:''' 2008-03-24

'''Current version:''' [http://www.mediafire.com/?ximuuuqeexm Download ] (Sansa v 1.0) 2008-05-15

'''Notes:''' Brings the Sansa Player and the Monkey together
[[Image:SansaTheme.jpg|right|thumb|300px|Sansa Theme]]
[[Image:SansaPlayer.jpg|center|thumb|150px|Float Player]]

<br clear="all" />

==MacMaster's Skins==

'''Author:''' [[User:MacMaster|MacMaster]] <br>
'''[http://macmaster.it/wordpress/?page_id=28 MM-Fansite]'''<br>

===MM Ultimate===

'''First released:''' 2008-01-23 <br>

'''Current version:''' [http://macmaster.it/wordpress/?page_id=20 Download MM Ultimate] (v2.1 - 2008-02-25) <br>
'''Notes:''' a blue version is also available.

[[Image:MM-Ultimate-Main.jpg|left|thumb|300px|MM-Ultimate Main Window]]
[[Image:MM-Ultimate-FloatPlayer.png|right|thumb|150|MM-Ultimate Mini Player]]
[[Image:MicroPlayer.jpg|center|thumb|200|MM-Ultimate Micro Player]]

<br clear="all" />

===MM PSP===

'''First released:''' 2008-02-12 <br>

'''Current version:''' [http://macmaster.it/wordpress/?page_id=29 Download MM PSP] (v1.1 - 2008-02-26) <br>

[[Image:mm-psp-main.jpg|left|thumb|300px|MM-PSP Main Window]]
[[Image:MM-PSP-FloatPlayer.jpg|right|thumb|150|MM-PSP Mini Player]]
[[Image:mm-psp-microplayer.jpg|center|thumb|200|MM-PSP Micro Player]]

<br clear="all" />
<br>
<br>
<br>

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://mediamonkeyskins.blogspot.com/2008/06/windows-media-player-11-skin.html Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://mediamonkeyskins.blogspot.com/2008/06/itunes-v7-skin.html Download] (v1.2 - 2008-02-17)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==NoHitter151's skins==
===ZuneSkin===
[[Image:ZuneSkin_Nohitter151.png|right|thumb|302px|NoHitter's Zune Media Player look-a-like]]

'''Author:''' [[User:Nohitter151|Nohitter151]]

'''First released:''' 2007-10-13

'''Original version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkin.mmip?attredirects=0 Download #1] (v1.6.2 - 2008-5-29)

'''Small player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSP.mmip?attredirects=0 Download #2] (v1.6.2 - 2008-5-29)

'''Slim player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSlim.mmip?attredirects=0 Download #3] (v1.6.2 - 2008-5-29)

'''SP Slim player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSPSlim.mmip?attredirects=0 Download #4] (v1.6.2 - 2008-5-29)

'''Notes:''' This skin is inspired by the Zune Media Player and has a definite 'Zune' theme. Thanks go to gege who designed the Micro Player.

<br clear="all" />

===VitreousBlue===
[[Image:VitreousBlue.png|right|thumb|301px|nohitter151's VitreousBlue skin]]

'''Author:''' [[User:Nohitter151|Nohitter151]]

'''First released:''' 2008-6-05

'''Current version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/VitreousBlue.mmip?attredirects=0 Download #1] (v1.0.1.0 - 2008-6-09)

'''Notes:''' Nohitter151's first original skin . Although it is based strongly on the Windows Vista theme, all buttons, icons, and player layouts are his own original designs. This skin makes heavy use of the font Segoe UI, a font that is preinstalled on Windows Vista. If you are on some other operating system you can install the font and MM will look as it does in the preview.

<br clear="all" />

== Authors with More than 2 Skin Screenshots ==

===Converted MM 2 to MM 3 skins (6)===
<br>[[Image:BlueMonkeyPreview_Nohitter151.png|right|thumb|300px|Main player and theme skins]]
'''[[MediaMonkey 2 Converted Skins]]'''<br>'''Most skins in this section have a style similar to this (with the small player)'''

<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
----

===Irishjet's Skins (4)===

'''[[Irishjet's Skins]] | Page for Irishjet's skins screenshots'''

----

===Magical Pig's Skins (3)===

'''[[The Magicalpig's Skins]] | Page for Magical Pig's skins screenshots'''

----

===Rovingcowboy's skins (14)===

'''[[Roving Cowboy's MM 3_ScreenShots]] |'''
[http://www.angelfire.com/tx3/rovingcowboy/mediadownloads.html My Media DownLoads]'''
'''[http://www.mediamonkey.com/forum/viewtopic.php?p=83082#83082 For More Information Read This Forum Thread]'''
<br>
<br>
----

===Royal Skin Recolored (6)===

''' Old default skin by Blake and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=153649#153649 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

Skins for MediaMonkey v3.0 and higher

2008-06-12T16:23:17Z

Morten: /* WMP11 */ Updated download link

[[Skinning|''Go back to the '''main''' skinning page'']]

Listed Below are some skins for MediaMonkey v3.x. To install:
#Download the .wsz / .msz / .mmip file (You may need to right click and use the "Save link as" or "Save target as" option in your internet browser).
##For .wsz/.msz files copy and save it to the MediaMonkey Skins sub-directory (usually C:\Program Files\MediaMonkey\skins\).
##For .mmip files, just double-click the file and it will automatically install.
:::('''Special note for users of Internet Explorer''': Internet Explorer may automatically change the file extension of your skin file to .zip. If this occurs, manually change the extension of the file back to .mmip or try downloading the file with a download manager or another browser such as [http://www.firefox.com Firefox] or [http://www.opera.com Opera].
#Restart MediaMonkey.
#Go to Tools | Options | Appearance | Skins and select whatever skin you wish to use.

'''Default skin now is Morten's [[Glided Skin]]; other skins included in the install package are Blue Glass and Casino Orange.'''

==Blake's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blake's WMP11 look-a-like]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Green Version:''' [http://www.mediafire.com/?awwntvwbhti G-Monkey11]

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

===MiPod===
[[Image:Ipodfull.PNG#file|right|thumb|300px|Blake's iPod inspired skin]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-04-05

'''Current version:''' [http://www.mediafire.com/?82kmnqki0n4 Download ]

<br clear="all" />

==DreadM's skins==

===Eclipse===

'''Author:''' [[User:DreadM|DreadM]]

'''First released:''' 2008-03-24

'''Current version:''' [http://www.mediafire.com/?4n3u4xnb4md Download #1 ] (Eclipse v 1.4.2) 2008-06-01

'''SmallPlayer version:''' [http://www.mediafire.com/?yvonoq9cynm Download #2 ] (Eclipse v 1.4.2 SmallPlayer) 2008-06-01

'''SlimPlayer version:''' [http://www.mediafire.com/?diynzwyjb0e Download #3 ] (Eclipse v 1.4.2 SlimPlayer) 2008-06-01

'''Eclipse Iconset:'''[http://www.mediafire.com/?dtgemjinpax Download #4 ] (Eclipse Iconset v 0.1) 2008-04-25

'''Notes:''' New version: Eclipse v1.4 with new players and iconset(floatplayers looks like mainplayers)
[[Image:Eclipse_v_1.4..jpg |right|thumb|300px|Eclipse Theme]]
[[Image:Eclipse_v1.4_news2.png |left|thumb|300px|Eclipse Player]]
[[Image:MicroPlayer.png |center|thumb|150px|New Microplayer]]

<br clear="all" />

===Sansa===

'''Author:''' [[User:DreadM|DreadM]]

'''First released:''' 2008-03-24

'''Current version:''' [http://www.mediafire.com/?ximuuuqeexm Download ] (Sansa v 1.0) 2008-05-15

'''Notes:''' Brings the Sansa Player and the Monkey together
[[Image:SansaTheme.jpg|right|thumb|300px|Sansa Theme]]
[[Image:SansaPlayer.jpg|center|thumb|150px|Float Player]]

<br clear="all" />

==MacMaster's Skins==

'''Author:''' [[User:MacMaster|MacMaster]] <br>
'''[http://macmaster.it/wordpress/?page_id=28 MM-Fansite]'''<br>

===MM Ultimate===

'''First released:''' 2008-01-23 <br>

'''Current version:''' [http://macmaster.it/wordpress/?page_id=20 Download MM Ultimate] (v2.1 - 2008-02-25) <br>
'''Notes:''' a blue version is also available.

[[Image:MM-Ultimate-Main.jpg|left|thumb|300px|MM-Ultimate Main Window]]
[[Image:MM-Ultimate-FloatPlayer.png|right|thumb|150|MM-Ultimate Mini Player]]
[[Image:MicroPlayer.jpg|center|thumb|200|MM-Ultimate Micro Player]]

<br clear="all" />

===MM PSP===

'''First released:''' 2008-02-12 <br>

'''Current version:''' [http://macmaster.it/wordpress/?page_id=29 Download MM PSP] (v1.1 - 2008-02-26) <br>

[[Image:mm-psp-main.jpg|left|thumb|300px|MM-PSP Main Window]]
[[Image:MM-PSP-FloatPlayer.jpg|right|thumb|150|MM-PSP Mini Player]]
[[Image:mm-psp-microplayer.jpg|center|thumb|200|MM-PSP Micro Player]]

<br clear="all" />
<br>
<br>
<br>

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://mediamonkeyskins.blogspot.com/2008/06/windows-media-player-11-skin.html Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=attach&type=post&id=211137 Download] (v1.2 - 2008-02-17)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==NoHitter151's skins==
===ZuneSkin===
[[Image:ZuneSkin_Nohitter151.png|right|thumb|302px|NoHitter's Zune Media Player look-a-like]]

'''Author:''' [[User:Nohitter151|Nohitter151]]

'''First released:''' 2007-10-13

'''Original version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkin.mmip?attredirects=0 Download #1] (v1.6.2 - 2008-5-29)

'''Small player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSP.mmip?attredirects=0 Download #2] (v1.6.2 - 2008-5-29)

'''Slim player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSlim.mmip?attredirects=0 Download #3] (v1.6.2 - 2008-5-29)

'''SP Slim player version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/ZuneSkinSPSlim.mmip?attredirects=0 Download #4] (v1.6.2 - 2008-5-29)

'''Notes:''' This skin is inspired by the Zune Media Player and has a definite 'Zune' theme. Thanks go to gege who designed the Micro Player.

<br clear="all" />

===VitreousBlue===
[[Image:VitreousBlue.png|right|thumb|301px|nohitter151's VitreousBlue skin]]

'''Author:''' [[User:Nohitter151|Nohitter151]]

'''First released:''' 2008-6-05

'''Current version:''' [http://sites.google.com/site/mediamonkeyfansite/file-cabinet/VitreousBlue.mmip?attredirects=0 Download #1] (v1.0.1.0 - 2008-6-09)

'''Notes:''' Nohitter151's first original skin . Although it is based strongly on the Windows Vista theme, all buttons, icons, and player layouts are his own original designs. This skin makes heavy use of the font Segoe UI, a font that is preinstalled on Windows Vista. If you are on some other operating system you can install the font and MM will look as it does in the preview.

<br clear="all" />

== Authors with More than 2 Skin Screenshots ==

===Converted MM 2 to MM 3 skins (6)===
<br>[[Image:BlueMonkeyPreview_Nohitter151.png|right|thumb|300px|Main player and theme skins]]
'''[[MediaMonkey 2 Converted Skins]]'''<br>'''Most skins in this section have a style similar to this (with the small player)'''

<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
----

===Irishjet's Skins (4)===

'''[[Irishjet's Skins]] | Page for Irishjet's skins screenshots'''

----

===Magical Pig's Skins (3)===

'''[[The Magicalpig's Skins]] | Page for Magical Pig's skins screenshots'''

----

===Rovingcowboy's skins (14)===

'''[[Roving Cowboy's MM 3_ScreenShots]] |'''
[http://www.angelfire.com/tx3/rovingcowboy/mediadownloads.html My Media DownLoads]'''
'''[http://www.mediamonkey.com/forum/viewtopic.php?p=83082#83082 For More Information Read This Forum Thread]'''
<br>
<br>
----

===Royal Skin Recolored (6)===

''' Old default skin by Blake and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=153649#153649 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

Glided Skin

2008-03-18T04:45:59Z

Morten: /* Skin information (by Morten) */

[[Image:Skin Glided.png|thumb|300px|Glided skin for MediaMonkey 3 by [[User:Morten|Morten]]]]
'''Glided''' is a skin created for MediaMonkey 3 by [[User:Morten|Morten]]. It's been the default skin since MediaMonkey 3.0 Alpha 5.

For more information, see the skin's [http://www.mediamonkey.com/forum/viewtopic.php?t=18433 forum thread].

== Skin information (by Morten) ==

'''Information about the skin:'''
* This skin is a collaboration between me (graphics) and Petr (coder of the skinning engine).
* It features a cool L/R-visualizer in the Volume Bar. This will automatically resize according to the position of the volume slider.
* Also pretty dominant is a spectrum analyzer in the information panel.
* This skin aims to give a lot of information, though keeping the aesthetics of a sleek design.
* Vista is it's main look-form.

'''Where is this skin headed?'''

The plan is to let this skin evolve with MM3 and it's further improved skinning engine. The following list contains no official information and is subject to change:
# Real Vista-compatibility: menus, dialogs, dropdown menus, ... in Vista-style when you're using Vista, and XP-style when you are using XP. (Depending on native support in MM)
# There is currently a big empty area if you're using a high-resolution screen. It will most likely be used by an area where you can switch between a playlist-viewer (custom) and a lyrics viewer.
# The Album Art area and other panels will be polished with overlays.
# Having an alternate (smaller) player and other miniplayers.
# Other enhancements made possible by the developing of the skinning engine.

Not So Frequently Asked Questions

2007-06-13T23:45:51Z

Morten: /* Showing lyrics within MediaMonkey */ Glided does not have lyrics embedded yet

<div style="margin-left: auto; margin-right: auto; background-color:#DDDDFF; border:1px solid #BBBBFF; padding:0px; width: 75%; font-size:100%; text-align:center; vertical-align:center">
{| style="width:100%;background:none;"
| style="width:60px;padding:.3em;" |[[Image:Information_sign_(60px).png|60px]]
| <span style="font-size:125%;">'''This page is temporary, and ''not'' a replacement for the FAQ.'''</span>
Please only add valuable content (not just typo fixes) that isn't in the FAQ already. The intention is to summarize multiple interesting forum posts, so this information can later easily be found back. This page may later be split into different pages once the necessary categories are fully known.
|}</div>

== MediaMonkey Graphical User Interface ==

=== Showing lyrics within MediaMonkey ===
'''Third Party Programs'''

* ''[http://www.crintsoft.com/minilyrics.htm MiniLyrics]'' with ''[http://www.mediamonkey.com/forum/viewtopic.php?t=9679 MiniLyrics Embedder]:'' Embeds the MiniLyrics program in MediaMonkey, so it minimizes and moves together
* ''[http://www.evillabs.sk/evillyrics EvilLyrics]'' with ''[http://www.mediamonkey.com/forum/viewtopic.php?t=9541 EvilTagger]:'' Adds external lyrics text files to the song's lyrics

'''Independant scripts'''

* ''[http://www.mediamonkey.com/forum/viewtopic.php?t=14494 MonkeyRok]:'' displays (not-timestamped) lyrics from your library
* ''[http://www.mediamonkey.com/forum/viewtopic.php?t=6755 Inline Lyrics]:'' displays (only LRC timestamped) lyrics in a progress bar at the bottom of your MM window
* ''[http://www.mediamonkey.com/forum/viewtopic.php?t=7508 Lyric Timer]:'' reads your (not-timestamped) lyrics and allows you to easily assign basic timestamps (for use with e.g. the Inline Lyrics script)
* ''[http://www.mediamonkey.com/forum/viewtopic.php?t=9592 Simple Lyrics Viewer]:'' simply statically shows the lyrics in a panel

'''Independant skins''' (starting from MM3)

* ''[http://www.mediamonkey.com/forum/viewtopic.php?t=15743 Glided]:'' will include a lyrics-viewer in the information screen in future releases.

=== Fix Strange User Interface Problems ===

'''Missing Internal Player'''

# Close MediaMonkey
# Open MediaMonkey's configuration file (normally "''MediaMonkey.ini''" in folder "''My Documents\My Music\MediaMonkey''")
# Locate the category [Appearance]
#:Set the values as follows:
#:* PlayerPosition=3
#:* PlayerSticky=0
#:* PlayerVisible=1
#:You can also just delete the above 3 lines, with the same effect.
# After restart MediaMonkey, the player should be back.

The problem can also be fixed if you delete registry key <code>HKEY_CURRENT_USER\Software\Songs-DB\Interface\Toolbars\TBXWinAmpSkin</code>

'''Purple Squares on the Skin'''

Set your Windows Display Settings to "High Color" or "Highest Color" through <code>Control Panel > Display > Settings > Color Quality</code>.

After a restart of MediaMonkey, everything should be fine.

'''Other Problems'''

# Close MediaMonkey
# Delete registry key <code>HKEY_CURRENT_USER\Software\Songs-DB\Interface</code>
# After restart MediaMonkey, the problem should be fixed.

In rare cases, a re-installation of MediaMonkey may be required.

== MediaMonkey Functionality ==

=== Customizable Global Hotkeys ===
Starting from MM3, customizable global hotkeys are built in. For MM2, you have to use external plugins:
* '''Winamp's default plugin:''' gen_hotkeys.dll
* '''HotKeyz:''' http://www.skynergy.com/hotkeyz.html
* '''HotKeyControl''' http://www.digital-miner.com/hkcontrol.html
* '''Other links (mostly Winamp plugins):''' http://www.mediamonkey.com/forum/viewtopic.php?t=7048

=== MediaMonkey Is Working Too Slow ===

Certain actions may require a lot of time:
* Adding new files or doing a startup scan (especially when searching for duplicates is enabled)
* Checking for duplicates
* Checking for unsynchronised tags
* Tagging a lot of tracks as once
So it might be quite normal that MediaMonkey is slow on such tasks.

'''Is your computer fast enough?'''
* Is your computer's processor (CPU) fast enough, and do you have enough RAM?
* Is your computer heavily loaded (servers, lots of applications, malware). Check out Windows' Task Manager. CPU should be significantly less than 100%, and you should have enough RAM left.
* Is your hard drive not to fragmented? Use Windows Defragmenter to defragment your hard drive.

'''Is your library clean and compact?'''
* See if compacting MediaMonkey's library helps though <code>menu File > Maintain Library ... > Compact database</code>
* Although MediaMonkey supports huge libraries (depending on your system of course), there is a limit.

'''Are Plugins or Scripts slowing causing slowdowns?'''
* See if disabling scripts helps:
** Rename MediaMonkey's ''Plugins'' folder to disable all scripts (including input and output plugins)
** OR disable only specific plugins by change their file extension (e.g. from ''.dll'' to ''.dll.off'')
* See if disabling scripts helps:
** Rename MediaMonkey's ''Scripts\Auto'' folder to disable all auto scripts
** OR disable only specific auto-scripts by changing their file extension (e.g. from ''.vbs'' to ''.vbs.off'')
** Rename MediaMonkey's ''Scripts\Scripts.ini file'' and create a new empty ''Scripts.ini'' file.

Always restart MediaMonkey to see the result.

=== Trim MP3 Silence ===

MediaMonkey can't trim silence of mp3's, but some input plugins (including DirectSound Output plugin) can remove it for playback.

To trim silence of mp3 files, you best use a specialized (but free) tool that preserves all audio quality (by directly working on the compressed mp3 file):
* [http://www.mptrim.com MPTrim] (simple interface): Trimming, fading, volume amplification and cleaning of mp3 files.
*: For the astronomical price of $70, the Pro version can do batch operations.
* [http://mpesch3.de1.cc/mp3dc.html mp3DirectCut] (graphical and/or command line interface): Trimming, splitting (with CUE file creation), cut/copy/paste, fading, volume amplification, normalisation and recording.

=== Wrong Track Length Display ===

A similar problem is the inability to seek, or strange problems with seeking within a playing song.

This is usually caused by errors in the music files, or by bugs in the used decoder (input plugin).

To resolve the problem:
* Analyze/repair mp3 files with [http://www.willwap.co.uk/Programs/vbrfix.php VbrFix] (for VBR files) or [http://mp3val.sourceforge.net Mp3Val] (for both CBR and VBR files).
* Try playing the song with another input plugin. For MediaMonkey, you can try MediaMonkey's mp3 plugin (in_wmp3.dll), the MAD plugin (in_mad.dll) or the Mpg123 plugin (in_mpg123.dll).
:To identify the plugin used to play the current song, click in the top-left corner of the player and click "Configure current input plug-in".
:To force a plugin not to be used (to test other plugins), disable it by changing its extension from ''.dll'' to e.g. ''.dll.off''. Restart MediaMonkey to see the changes.

== Windows Shell ==

=== Remove MediaMonkey from the AutoPlay Launch Dialog ===

# Start Regedit.exe (continue with caution! -- create a backup or a System Restore Point first)
# Browse to <code>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\AutoplayHandlers\EventHandlers\</code>
#: In all subkeys (or only those you want), look for and delete the "MediaMonkey...Handler" entries: "MediaMonkeyBurnHandler", "MediaMonkeyPlayCDHandler", "MediaMonkeyPlayHandler", "MediaMonkeyRipCDHandler", "MediaMonkeyStartHandler"
# Browse to <code>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\AutoplayHandlers\Handlers\</code>
#: Delete all the "MediaMonkey...Handler" subkeys (or only the ones you want, e.g. the enties you deleted in the previous step)

The same can be done using [http://www.microsoft.com/windowsxp/downloads/powertoys/xppowertoys.mspx Microsoft Powertoys' TweakUI].

=== Re-enable a disabled Windows Balloon Tip ===
Starting from MM3, MediaMonkey uses it's own notification window. This information is only applicable for MM2.
# Start Regedit.exe (continue with caution! -- create a backup or a System Restore Point first)
# Browse to <code>HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced</code>
#: Change the value for the EnableBalloonTips entry to 1, or completely delete the EnableBalloonTips entry.
By default, MediaMonkey shows the Balloon Tip when a song starts playing. This can be changed in <code>menu Tools > Options > General > Pop-up track info in tray</code>.

The Windows sound associated with the Balloon Tip is "System Notification" by default.

=== Using Virtual Drives ===
Virtual Drives can be used to create a drive letter for a certain directory on your file system. It can be used to put your prefered music folder on the top-level in the My Computer node.

Run the command <code>SUBST T: "C:\Some\Path\Leading\To\My\Music"</code> to create a virtual drive with drive letter T leading to the "C:\Some\Path\Leading\To\My\Music" folder.

This virtual folder exists until you shut down Windows. If you want to have this Virtual Drive always available, you can use a command script to automatically run when Windows starts. Alternatively, you can create an [[Introduction_to_scripting|auto-script]] for MediaMonkey.

=== Using Differentiated Music File Icons ===
This works on Windows 2000, Windows XP, and probably also on Windows9x.

*Make sure MediaMonkey is set to *not* automaticly associate itself with certain file extensions. Uncheck "Re-associate..." in <code>menu Tools > Options... > General > File Types</code>.
*Open My Computer and then <code>menu Tools > Folder Options > tab File Types</code>
**Select the file extension (e.g. FLAC) of which you want to change the icon, press the Delete button and acknowledge.
**Press the Add button and type in the file extension you want (e.g. FLAC). Make sure there's <New> or no text in the text box (when you have clicked the advanced button). This will add an "independant" file extension that will enable you to change it's file icon independantly. Press OK to add the extension.
**Then, with the file extension (e.g. FLAC) selected, press the advanced button. Leave the upper text box empty, but change the ico as you wish. Then add the file actions (using the New button):
**:''Play in MediaMonkey'' ("C:\Program Files\MediaMonkey\MediaMonkey.exe" "%1")
**:''Play Last in MediaMonkey'' ("C:\Program Files\MediaMonkey\MediaMonkey.exe" /ADD "%1")
**:''Play Next in MediaMonkey'' ("C:\Program Files\MediaMonkey\MediaMonkey.exe" /NEXT "%1")

::For all these actions, select Use DDE and fill in:
::*''application:'' MediaMonkey
::*''subject:'' System

:*Press OK until all dialogs are gone.

The same can be done much faster and easier using a specialized tool, or by following the instructions in [http://www.mediamonkey.com/forum/viewtopic.php?p=49021#49021 this forum post].

== Device Support ==

=== Using UMS Devices on Windows 98 ===

Windows 98 doesn't support USB Mass Storage Devices out-of-the-box. Therefore you have to install separate drivers from [http://www.technical-assistance.co.uk/kb/usbmsd98.php here].

=== Using iPod Devices on Windows 98 ===

The above drivers should also work for iPods. The following drivers are specifically for iPod:
* http://www.98-drivers.com/ipod.html
* http://www.redchairsoftware.com/anapod/support/proassist.php?c=9899
Complete iPod-on-Windows98 instructions can be found on the [http://forums.ipodlounge.com/showthread.php?s=9cd9ae2e8947cfeb350247a0284b0081&threadid=6581 iPodLounge Forum]

How to skin MediaMonkey versions 3 and 4

2007-05-26T10:25:03Z

Morten: /* INI File */ Typo

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
:'''MainTreeBackground''' - background image for the nodes (''Available in Alpha 5 and newer builds'')
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distance, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available in Alpha 5 and newer builds;''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

.msz-file

2007-05-25T18:27:52Z

Morten:

An .msz-file is a file-extension which in MediaMonkey v3.0 is used as a container for skins. It really is a renamed extension from a zip-file and can contain main theme, player-skins and custom icons.

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:23:47Z

Morten: /* Usable Masks */

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
:'''MainTreeBackground''' - background image for the nodes (''Available in Alpha 5 and newer builds'')
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available in Alpha 5 and newer builds;''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:23:20Z

Morten: /* Customizing the Theme */

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
:'''MainTreeBackground''' - background image for the nodes (''Available in Alpha 5 and newer builds'')
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available from MediaMonkey 3 Alpha 5;''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:19:18Z

Morten: /* Usable Masks */ Clearification

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
:'''MainTreeBackground''' - background image for the nodes (BitmapObject)
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available from MediaMonkey 3 Alpha 5;''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:16:00Z

Morten: /* Customizing the Theme */ Added MainTreeBackground information

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
:'''MainTreeBackground''' - background image for the nodes (BitmapObject)
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available from MediaMonkey 3 Alpha 5 (build 1035);''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:13:15Z

Morten: /* Usable Masks */

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br>
<br> ''Available from MediaMonkey 3 Alpha 5 (build 1035);''
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-25T18:12:40Z

Morten: /* Usable Masks */ Clearification

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
Available from MediaMonkey 3 Alpha 5 (build 1035);
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

How to skin MediaMonkey versions 3 and 4

2007-05-22T19:54:36Z

Morten: /* Usable Masks */ - Added three more masks

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order
<br> %Cn - custom field (n must be between 1 and 5)
<br> %PC - current track in playlist
<br> %PT - total tracks in playlist

Skins for MediaMonkey v3.0 and higher

2007-05-20T14:29:36Z

Morten: /* WMP11 */

[[Skinning|''Go back to the '''main''' skinning page'']]

'''Listed Below are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" or "Save target as" option in your internet browser.'''

==Blake's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blake's WMP11 look-a-like]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Green Version:''' [http://www.mediafire.com/?awwntvwbhti G-Monkey11]

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

===MiPod===
[[Image:Ipodfull.PNG#file|right|thumb|300px|Blake's iPod inspired skin]]

'''Author:''' [[User:Blake|Blake]]

'''First released:''' 2007-04-05

'''Current version:''' [http://www.mediafire.com/?82kmnqki0n4 Download ]

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=147434 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

== Authors with More than 2 Skin Screenshots ==

===Rovingcowboy's skins===

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More Information Read This Forum Thread]
'''

'''[[Roving Cowboy's MM 3_ScreenShots]] |''' [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]'''

===Default Skin Recolored===
'''by Blake and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

How to skin MediaMonkey versions 3 and 4

2007-05-05T10:58:42Z

Morten: Small language

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked in it’s default position and can’t be docked to any other position.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order

Walkthrough on how to skin MediaMonkey v3

2007-05-03T21:34:48Z

Morten:

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you have any questions, please ask me ([[User:Morten|Morten]]) or one of the other skinners. We will put the question and answer here.

How to skin MediaMonkey versions 3 and 4

2007-05-03T21:34:17Z

Morten: Added link to a guided skin page.

''This entry is only for documentation purposes. For a walkthrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked on it’s default dock and can’t be docked to any other dock.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order

How to skin MediaMonkey versions 3 and 4

2007-05-03T21:33:39Z

Morten:

''This entry is only for documentation purposes. For a walktrough of how to skin your MediaMonkey interface, please see the [[Walkthrough on how to skin MediaMonkey v3]].''
==Introduction==
MediaMonkey offers a fair amount of flexibility to customize the look of the application. This document provides graphic designers with the information needed to make MediaMonkey even better looking than it already is.

The UI elements that can be modified are:
#The MediaMonkey Skin
#*The application Theme (i.e. the look of buttons, borders, status bars, title bars, fonts, etc.)
#*The skin of the various incarnations of the player (the main player, mini-monkey, and micro-monkey) and the font of the text within
#*Background images for various panels
#Icons within the application

==The MediaMonkey Skin==
A MediaMonkey skin consists of the Theme, the Player skins, and several background images that together make up a ‘skin’. Skins are packaged as .msz files, which are simply .zip files with an .msz extension, containing all skin elements, saved to:
:''\MediaMonkey\Skins\skinname.msz''
so that users can choose a skin via <code>Tools > Options > Skin</code>.

Note that during the skin creation process, skin components can be created/edited in
:''\MediaMonkey\Skins\Skinname\<skin components>''
so that there’s no need to continually repackage the skin during skin development. Once you’re satisfied with your edits, you can just Zip the contents of the ''\Test'' directory into a zip file, rename it to ''<Skinname>.msz'', and place it in the ''\MediaMonkey\Skins\'' directory to see the final result.

===Customizing the Theme===
The MediaMonkey Theme is what controls the overall look and feel of most aspects of the application (e.g. the titlebar, the buttons, the status bar, tabs, checkboxes, etc.). The theme is controlled by Theme.mskn which contains graphical elements and mappings of these elements to various UI objects. To edit a theme:
#Extract a skin (e.g. ''Casino Blue.msz'') to
#:''\MediaMonkey\Skins\Test\''
#Download the KSdev theme editor from
#:http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe
#Run the Theme Editor and load ''Theme.mskn'' from the ''\Test'' directory into the theme editor and edit it and save it.
#In MediaMonkey, Go to <code>Tools > Options > Skins</code> and select the new Test skin to see the results of your work (to refresh the skin, just switch skins in the Skins configuration panel).

During the editing process, there are 2 approaches you can take:

*If you have graphic expertise, but don't want to get into the details of configuring the size of buttons, their behaviour, setting margins, etc. the simplest approach is to create a new theme based on the graphics of an existing theme:
*#Click <code>File > Export Bitmaps</code> and then edit the images, while making certain to maintain their exact dimensions
*#Click the Images node in the ThemeEditor tree, select individual images and click 'Replace' to replace them with the newly edited images
*#After replacing all the images, resave the .mskn file
*#Switch to the skin entitled 'Test' to see how the changes look

*If you want much greater control and flexibility to control all aspects of a theme, you can create a new theme based on an existing one, but in addition to changing graphics images, you can also change various additional characteristics of the theme (e.g. fonts) by editing the properties of various objects that appear in the MediaMonkey UI.

Instructions on the use of Theme Editor is beyond the scope of this document. The best approach is to edit the properties of various objects in the tree and then saving the theme file and test out the Skin containing the new theme file by switching to it in MediaMonkey.

Below is a reference to all ''Theme.mskn'' objects used in the MediaMonkey UI:
;Form
:This defines the MediaMonkey frame, and buttons within the title bar
:'''Caption\Title\Font''' - caption font
;MenuBar
:Only the ToolbarItem is used along with;
:'''ItemButton''' (TSeButtonObject type) - This defines look of the top menu item (items like File, Tools etc.)
:'''SubitemButton''' (TSeButtonObject type) - This defined buttons within menu (all items in menu)
;Popup Menu
:This defines the look of menus
;CheckBox
:Defines the look/behaviour of checkboxes
;RadioButton
:Defines the look/behaviour of radio buttons
;ScrollBar
:Defines the look/behaviour of scrollbars
:'''NCArea''' - defines bottom right corner background (area between horizontal and vertical scrollbars)
;Button
:Defines the look/behaviour of OK/Cancel/Other buttons that appear within dialogs
;SpeedButton
:Defines the look/behaviour of buttons on the toolbar
;GroupBox
:Defines the group boxes that are used in some dialogs such as encoder selection dialog
;ProgressBar
:Defines the look of progress bar that's used to indicate status. Currently only the horizontal one is used.
;TrackBar
:Defines the look of the sliders/tracks used for the equalizer
;Listbox
:Defines the look of listboxes (e.g. the Scan Folders dialog, tracklist)
:'''Item\ActiveBitmap''' - for selected item background
:'''ItemAdv\ActiveBitmap''' - for unfocused selected text background
:'''ItemAdv\ActiveFont''' - for unfocused control selected text font
: -
:ListBox colors and fonts:
:'''Colors\ListBox\Body''' - used to set default background colour
:'''Fonts\ListItemTextNormal''' - for normal text
:'''Fonts\ListItemTextHot''' - for 'hot' text
:'''Fonts\ListItemTextSelected''' - for selected text
;Combobox
:Defines the look of combo boxes
;SpinButton
:Used for Up/Down arrows
;Panel
:Used for docked dialogs
;Tabs
:Used for TabSheets
;ControlBar
:Used to control the look of toolbars
;Toolbar
:Used to control the look of toolbar backgrounds.
:'''SubitemFont''' (TextObject) - font for popped menu items.
;Header
:Used to control the headers in lists
:'''Section\Font''' - header font
;StatusBar
:Controls the look of the status bar
;ToolWindow
:Controls the look of mini dialog frames (e.g. Equalizer, Album Browser)
:'''Caption\Title\font''' - title font
;Container
:Used for some backgrounds
;Splitter
:Divides up the toolbar
;VirtualTree
:Defines the look of the VirtualTree (TrackList, MainTree etc.)
:'''Panel''' - for defining border
:'''DragSelection''' - selection color for mouse-use drag selection
:'''DragTarget''' - selection color for dagging target node
:'''TrackListOdd''' - background image for odd rows in tracklist
:'''TrackListEven''' - background image for even rows in tracklist
:'''NowPlayingOdd''' - background image for odd rows in now playing
:'''NowPlayingEven''' - background image for even rows in now playing
;InfoPopup
:Defines background and fields positions within popup info window
:'''Frame\Background\AlbumArt''' - position and size of the place for album art image
:'''Frame\Background\*''' - all fields with English names can be defined as TextObject (like Artist, Title etc.)
;NavBar
:Navigation bar settings
:'''Background''' - navigation panel background
:'''Node\Selection''' - background for selected node (mouse is hover it)
:'''Node\DropMark''' - drop down sign
:'''Node\Background''' - background for path node
:'''Node\Caption''' - path node font settings

Also keep in mind the following hints:
*MediaMonkey has a default theme of Default.mskn that's used if a xxx.msz archive doesn't contain a Theme.mskn file. You can edit this if you like.
*Minimize single-pixel transparency in bitmaps to avoid performance hits
*Try to minimize the use of margins in your objects as they decrease performance
*It is best to use bitmaps that are distinct for each object (rather than a single image containing all objects) to avoid performance hits
*ThemeEditor has a bug which sometimes causes the bottom right pixel in an image to become transparent. To avoid this, add an extra pixel of padding to the right of the image, but don't use the rightmost column of pixels in your objects.
*All fonts in the fonts node should be set to 'Arial' to ensure correct functionality in unicode environments
*For Font properties other that in 'Fonts' node (like ListBox\ItemAdv\ActiveFont). They allow to use 'MS Shell Dlg 2' font and thus it should be used when needed (such occasions are appear in the above list) -- the trick with 'Arial' font isn't used there).
*Before finalizing your theme, make sure to test it at different DPI settings

===Customizing Background Images===
There are a number of background images used in MediaMonkey that are part of a skin (i.e. they are included within the ''<Skinname>.msz'' file. These include:
*''sdb_background_playing.bmp'' – non-scrollable background for the Now Playing list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_list.bmp'' – non-scrollable background for the Track list (optional – use if scrollable background not defined in the Theme)
*''sdb_background_tree.bmp'' – non-scrollable background of the tree
To customize these, just save the bitmaps to a skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

===Customizing Icons===
The default MediaMonkey icons can be replaced globally to be used with any user-selected skin, or can be included with a specific skin if custom icons are desired for that skin.

To create a complete icon set to be used with any skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Icons\''
#To customize the icons, just edit any of the icons in the ''\Icons\'' directory, and restart MediaMonkey. The new icons will appear.

To bundle specific custom icons within a Skin:
#Download all icons via http://www.mediamonkey.com/contrib/artwork/icons.zip
#Extract the icons from the .zip file to ''\Program Files\MediaMonkey\Skins\<Skinname>\Icons''
#Delete any icons that you do not plan to customize
#Edit any of the icons that you wish to include with the skin
#To customize the skin just save the icons to the skin directory or archive (msz file), and then switch skins or restart MediaMonkey to see your work.

Note that 2 icons aren’t exactly icons:
*NoAArt.png for unknown art in Album Art window
*NoAArtNew.png for unknown art in Album Art views

===Customizing the Player===

====Basic Information====
MediaMonkey v3 (MM3) comes with a new feature called Skinnable Player, which supports user defined player with its own skins (independent of MM skin).

There are 3 players in MM3:
#Classic player in the main window.
#Mini-player (MiniMonkey mode in older versions of MM)
#Toolbar controller (new player placed on windows taskbar)

All of these players can be unique with different design and look.

====Player Files====
Every player skin is stored and defined in 2 files defining its skin and settings.

Classic player is defined in files '''Player.mskn''' and '''Player.ini'''.
Mini-player player is defined in files '''FloatPlayer.mskn''' and '''FloatPlayer.ini'''.
Toolbar controller can have two types: horizontal (when taskbar is on top or bottom edge of the screen) or vertical (when taskbar is on left or right edge of the screen). File name format for these types is '''MicroPlayerH''' (for horizontal) and '''MicroPlayerV''' (for vertical). Horizontal toolbar controller is then defined in '''MicroPlayerH.mskn''' and '''MicroPlayerH.ini''', and vertical in '''MicroPlayerV.mskn''' and '''MicroPlayerV.ini'''.

MSKN file is standard ThemeEngine 6 (older version of TE can be used, but with no warranty) format with maximum compression. See to MSKN File section for more information about this file.

INI file is configuration file in a text mode and can be edited with any text editor.

All of these files must be stored in WSZ file with MM3s skin together. WSZ file is standard ZIP file with a changed file extension only.

When any of players in MM3 hasn’t its files in WSZ, MM3 uses built-in skin for missing player.

For development purposes, individual skin files don’t have to be packed in WSZ file, but can be stored all in a subfolder of MM\Skins folder.

====MSKN File====
Players MSKN file can contain these objects:

'''PlayerBackground''' (SkinObject)
<div style="margin-left: 25px;">Defines background of the Player. This object must contain object Frame and into this object you can store all parts of player background (like left side, center and right side).

Example:

PlayerBackground
:Frame
::LeftSide
::Center
::RightSide

With this hierarchy you can define player, which can be resized (center part can be tiled, stretched etc. when player is being resized).

Every player can have transparent parts of its design. One requirement is, that every transparent part must have the same color as color in upper left corner (point 0;0).

PlayButton, PauseButton, StopButton, PrevButton, NextButton, PlayPauseButton, ShuffleButton, ContinousButton, PlaylistButton, AutoDJButton (ButtonObject)

These objects represent basic player buttons. When you need to use more than 3 state buttons (like for PlayPauseButton where you need to design button for play and for pause both), then you can create objects with _UP and _DOWN postfixes and in INI file set to StateButton type (see below).</div>

'''SeekBar, BalanceBar, VolumeBar''' (SkinObject)
<div style="margin-left: 25px;">Every seekbar can define its background (in these objects) and can define slider design with HorzSlider or VertSlider as its descendant.

Example:

SeekBar - this object defines seekbar background
:HorzSlider - this object defines horizontal slider for seekbar
:VertSlider - this object defines vertical slider for seekbar</div>

'''Visualization {Left/Right}''' (BitmapObject)
<div style="margin-left: 25px;">This object defines bitmap for visualization background. If you use themed visualization then you must define VisualizationLeft and VisualizationRight (instead of Visualization) as backgrounds for left and right channels.</div>

'''Visualizations''' (SkinObject)
<div style="margin-left: 25px;">Container for themed visualization bands. In this container you can define visualization steps for separate channels or for both together. All visualizations steps is defined as LeftBand''0''..LeftBand''n'', RightBand''0''..RightBand''n'' or Band''0''..Band''n'' for both channels. Number of steps is defined in INI file of the player.</div>

'''MonoStereoLabel''' (ButtonObject)
<div style="margin-left: 25px;">Indicator for mono/stereo. Mono indicator put into Bitmap and stereo into BitmapDisabled.</div>

'''DigitPanels''' (ButtonObject)
<div style="margin-left: 25px;">Every digit panel uses bitmaps for its digits. In skin you can create 2 types of digits: small and normal.
Normal digits are named as Digit%, DigitEmpty and DigitNegative, where % is value (like Digit0, Digit4 etc.).
Small digits have the same rules as normal digits, but name is SmallDigit.
For normal digits you can define TimeDivider object, which represents digits divider (like ‘:’, ‘-‘ etc.).</div>

'''Rating''' (ButtonObject)
<div style="margin-left: 25px;">This button object is used for manage rating on a skin. There are need to be defined Bitmap and BitmapDisabled fields, where Bitmap is “highlighted” rating star and BitmapDisabled is “grayed” rating star.</div>

'''StatusPanel''' (BitmapObject)
<div style="margin-left: 25px;">This panel is used as background for player’s status signs (like “playing”, “paused” etc.).</div>

'''StatusImages/*''' (TBitmapObject)
<div style="margin-left: 25px;">Status images for player’s status (can be defined StatusPlay, StatusStop and StatusPause).</div>

'''AlbumArt''' (TBitmapObject)
<div style="margin-left: 25px;">Custom defined AlbumArt image for tracks, that doesn’t have defined cover.</div>

====INI File====
In ini file is many sections which corresponds with most names in MSKN file and can contain:

'''''PlayerSkin'''''

Basic information about skin and can contain these values:
;EngineVersion
:for which version of SkinnablePlayer is this skin designed (default 100 as 1.00 version)
;Resizable
:How can be skin resizeable. You can type 4 values with left, top, right and bottom sequence delimited with comma.
: -
:Example :
:Resizeable=1,0,1,0 – skin can be resized by left and right edges
;Size
:Initial size of skin.
;TimeFormat
:Default time format.
;DockAtMostBottom
:This value defines if player can be docked at most bottom (under status bar) in main window.
;DockLocked
:If this value is set to 1, player is always docked on it’s default dock and can’t be docked to any other dock.

Sections can have these names:

''PlayPauseButton, SeekBar, VolumeBar, BalanceBar, PrevButton, PlayButton, PauseButton, StopButton, NextButton, ShuffleButton, ContinousButton, AutoDJButton, MonoStereo, SongTitle, TimeDisplay, SearchBar, EQButton, PlaylistButton, KbpsDisplay, FreqDisplay, AlbumArt, Visualization (for standard MM build-in visualization), VisualizationLeft and VisualizationRight (for user themed visualization), MinimizeButton, MaximizeButton, CloseButton, SwitchButton, Rating, StatusPanel''

Type of an object is defined by Type value and can be one of this:

''Button, StateButton, DigitPanel, Text, TrackBar, BitmapLabel, Panel''

Note : Rating and StatusPanel objects must be a type PANEL.

Other values, which can be defined:

;Resizable
:Defines, if object can be resized when user resizes player in Left,Top,Right,Bottom format. Also it defines controls alignment while resizing. If you define left/right or top/bottom to 0, control always stays in it’s position relative to resized size (e.g. if control in basic size will be on center and player is resized, then control will always be on center).
;Pos
:Position of the object in Left,Top format.
;Size
:Size of the object in Width,Height format. (Note: when height is greater than width, then object is defined as vertical .. this is usable for defining vertical seekbars).
;Transperent
:Ability to be transparent (1 indicates YES, 0 no).
;TextMask
:Text mask define which and how data is showed. See below for which masks can be used.
;SmallDigits (only for DigitPanel type)
:Defines, if digit panel uses small or normal digits (more about it at MSKN File section). 1 is Yes, 0 no.
;ThumbSize (only for TrackBar type)
:Defines thumb size.
;ShowLimitH, ShowLimitV
:These values defines horizontal and vertical limits for showing defined object. If players width/height is smaller than defined limit, then object is invisible.
;FontColor
:This value is used only for text objects. It defines font color in format RRGGBB (like FFFFFF is white color).
;FontHeight
:This value is used only for text objects. It defines font height in pixels.
;FontName
:User defined font for text object.
;TextAlign
:Text aligning. Can be -1 for left-align, 0 for center or 1 for right-align.
;TrackReversed
:Basic trackbar orientation have min value at the left or top of the trackbar. With this boolean value you can reverse this orientation (like for vertical volume bar which has max at the top of the trackbar). This is usable only for trackbars.
;Steps
:Defines steps of the user themed visualization. Images for this steps is defined in MSKN in Visualizations container.
;Scrollable
:For text objects it can be defined for enable/disable scrolling functionality (like for time display).
;CenterOffsetX, CenterOffsetY
:This values defines contant position of the object relative to player center (left/top edge of the object). Like CenterOffsetX=-20 defines, that the objects left edge will be always 20px left of the center of the player.
;Lock<edge>Distange, Lock<edge>Object
:Control can be locked by any of edge to any other control. If control, which is locked to is moved or sized, this control is automatically adjusted. Like:
:LockRightDistance=-50 - right edge of the object will be always 50 pixels left from
:LockRightObject=PrevButton - PrevButton’s left edge

By default, skinning engine detects buttons clicking area as non-transparent parts of the buttons. In some cases (like when you’re using images with alpha channel), this detection can be very limited. For this reason, every buttons can have it’s own mask in BitmapFocused property of the button object.

In addition you can use custom defined objects, which lets you to give to your skin more functionality and lucidity.
Custom objects can be defined as Custom% (where % is unique number for anyone custom field, e.g. Custom1, Custom2, Custom3 etc.).

Switching between all players can be done via MediaMonkey (system’s minimize button and/or settings of the MediaMonkey) or you can use Player buttons:

'''MinimizeButton''' – in main player it switches to mini-monkey. In mini-monkey it uses MM settings for minimize.<br>
'''SwitchButton''' – switches to micro-player (in all cases)<br>
'''MaximizeButton''' – maximizes to main from mini-monkey or micro-monkey<br>
'''CloseButton''' – closes whole MM<br>

Custom objects can have this fields:
'''Pos, Size, Transperent, TextMask, ShowLimitH, ShowLimitV'''
:These fields has a same sense as above.
'''Type'''
:Types for custom objects is same as for classic objects, but any new types are allowed :
::IMAGE
:::Image control. Source of the image is defined in Source field (see below)
'''Source'''
:Source for image object (image path and filename relative to MM directory) or “<Cover>” text to show album cover of the loaded track.

====Usable Masks====
mm:ss – time format (can be used with digit panels like TimeDisplay)

<nowiki>#</nowiki> - any digit: MM3 replaces # char with digit. You can use more than one # char (for 3 digits you can use ### etc.). This can be used with digit panels like FreqDisplay etc.

<br> %A – Artist
<br> %R – Album artist
<br> %L – Album
<br> %S – Song
<br> %P – Playlist position
<br> %I – Song position
<br> %H – Song length
<br> %J – Time to play
<br> %G – Genre
<br> %C – Author
<br> %U – Custom1
<br> %V – Custom2
<br> %W – Custom3
<br> %E – Songs file extension
<br> %F – Filename
<br> %Y – Year
<br> %T – Song order
<br> %B – Bitrate
<br> %M – Songs BPM
<br> %D – Temporary order

File talk:Splash.jpg

2007-04-17T18:17:08Z

Morten:

That is one scary Splash-screen... :S

File talk:Splash.jpg

2007-04-17T18:16:55Z

Morten:

That is one scary Splahs-screen... :S

How to convert MediaMonkey v2.5 skins in to v3.0 skins

2007-04-15T21:45:43Z

Morten: How to Conver MediaMonkey v2.5 skins in to v3.0 skins moved to How to convert MediaMonkey v2.5 skins in to v3.0 skins: Typo

'''If this has any missing data fill it in but please try and keep it simple to follow.
This is not an easy task to follow for the newbies, and is best left to those
that have been skinning for both versions.
Or are skinners of several other skins
and know what items and or steps might
have been left out. or left for them to presume.'''

----
this is not a fast walk through
this is how to convert media monkey 2 skins to
use in media monkey 3.
I presume that if your doing this you are already
a skinner and know some things about this before
you started it.

but I will say it in as best of a step by step manner
that I am able to do anyway.

1.make a folder for your converted skin.

2.make this folders in side that folder.
Floatplayer
Icons
MicroplayerH
MicroplayerV
Player
Theme

3.now you need to get some files from the different skin's for this one
converted one to work.

you need these files and images from the mm2 skin.

the shufrep.bmp
the text.bmp
the sdb_background_list.bmp
the sdb_background_playing.bmp
the sdb_background_tree.bmp
the Main.bmp
the Cbuttons.bmp
Theme.mskn

those are all that is used by the mm3 skin if you convert the old skin

4. copy those files and paste them in to the folder you made in step 1

5. now copy
the sdb_background_list.bmp
the sdb_background_playing.bmp
the theme.mskn

in to the folder you made for the theme.mskn file

6. now move the
shufrep.bmp
main.bmp
cbuttons.bmp

in to the folder you made for the player.

now is the time to think about the size of the player.
open the three you just changed in the photo editing program you use
if you make the skin exactly like the player was in mm2 then you need to
resize the images to fit larger screens.
for the skin I re did I changed the height by adding 14 pixels to the old

winamp skin making it 150 pixels high this was done while telling the editing

program to keep the same ratio when making it larger.
in doing it to that size the player is very useable in the 1024 x 768 pixel

screen size.
but you must change all 3 images you moved in step 6 to the same ratio

other wise it wont look the same.

7.now to the mm 3 skins you have.
go in to the folder for one of your mm 3 skin's theme.mskn files if you

unzipped the default skin and saved it in folders.?

all you need to do is copy the infopopup.bmp and the sel.png
now go to the folder you made for your converted mm2 skin's theme file.
that you made in step two and paste these images in there.

8.now go back to the mm3 skin's folder and go in to each folder in there and

copy all the images in those folders and paste them in to the
other folders of the same name you made in step 2.
and copy and paste any of the files you see in the mm3 folder in to the

folder you made in step one.
all Except the theme folder and the theme.mskn you don't need
this file of the mm3 skin.

9. now you should be finished with the files from the mm3 skin.
so it is time to once again use the photo editing program.
go in to the folder for the player of the skin your converting.
now you will see all the image files in there.
delete the background bmp from the mm 3 player and rename
the main.bmp to the background.bmp

10. open the skin mini layout bmp in the photo editing program.
you will see on there lots of images.
they are placed in certain places for the exe to find.
but not all of them. just the long thin player the mute button the volume slider

buttons and the seek thumb image, and the images for the audio visual

meters. and the star rating image. and the short player sides up in the top
left hand corner. those are the only images on that skin layout map.
if you are making the player fixed and not able to slide to a longer image.
then you don't need that long thin player image.
I would suggest not making it a resizable image if your converting the mm 2

skin you don't want it to resize.

so take your clone tool in the image or your paint over tool and clone or paint

the same pink background color over the images I did NOT mention.

take a look at this skin guide [[Image:Mm_2_to_mm_3_guide_skin_mini_layout1.jpg]]<br>
it has the needed images for the converted mm

2.5.5 player skin.
on it there is two vertical audio visual meter images this is for horizontal

meters.

after you get all the images colored or cloned over with the pink background
you then open the other images in the folder with your edit program.
then you copy them in the edit program then paste them on to the skin mini

player layout image.

you now have a new map image save this and get out of the editor.

11.you now open the theme skinning engine. and open the player.mskn file
now on the skinning engine you click on the plus sign by the word images.
this shows you all the images in the player mskn file.
you select each image and then press the replace button.
then browse to the image in the folder you just changed and open the

changed image and click okay it will be placed in the theme mskn.

12.after that is all finished which is only 2 images it should only be the
background.bmp and the mini skin layout.bmp that you need to replace.
you now go to the plus sign by the word objects.
there you need to find the place the images are used, and change the size
of the background image client to fit the size you changed the main image

too. make sure you adjust the size of the left center and right image.
you do that on the right hand side of the skinning engine where all the code is

at. look at the ones called height and width make sure they say the same

your player is. in height. and the width is half the size of the player.
the size you should get when you changed the size to 150 height main image

would have been 355 pixels wide.
so make the left and the right images sizes 175 pixels wide. this will leave 5

pixels for the center image to be.

13 now you got those numbers changed on the right you need to go back to

each one left center and right. and near the top of the code on the right you

will see the word bitmap select that word then click on the arrow that shows

up on the right of the word. this opens the image panel that you want to use
for that frame. set the lines on the image to the same size you put in the

code area.
do that for all 3 of the background images.

14. now do that for all the buttons you see. listed on that area. go through

and pick the button images you need to use on that skin.
make sure Absolutely sure the numbers on the image panel match the

numbers in the code and match the size of the image if you are using the

whole image. mm 3 must have the numbers matching or it will have slight

errors and or major errors.
if you have the main image 150 pixels high but you set the image
in the panel to 151 pixels high mm 3 will crash when you try to use the skin.
the one pixel either way error handling does not work or is voided in mm 3.

so make the number match.
you might have to add in stop button and a pause button. you will need to

rename the playpause button to only " play "
you will have to do the same in the ini files add in the stop and play, then

rename the play pause button there also or they wont be found by the mm 3.

if you want a close button you add that in too. you will have to make
sure you have an image for the close button either add one in to the
player mskn file or use one that is already there.

if you add the buttons which you will if you want a copy of the mm 2 skin.
you need to make sure you use the 5 image button code. that you see
on the play button..

when you pick the image for the focused buttons it is best to use
the pink background on that one and or no image at all. this will
allow the button to go back to the first image it showed.

15. save the player mskn file when you finish. and close the theme skin

engine. now in the folder for the player. you copy the mskn file and the

images.

get out of the player folder. by going back to the folder you made in step

one. where you can see the other folders for the same skin your working on.
find the one for the floatplayer go in to that folder and paste the images and

player mskn file in this floatplayer folder.
now delete the float player mskn file that is in there. and rename the

player.mskn file you just pasted in the folder to floatplayer mskn you just

saved your self from repeating the steps you did in making the player file. by

doing this you made the float player the same as the main player.

16. now copy the floatplayer mskn file go back to the folder you were just in

where you can see all the other folders for the skin. and paste the

floatplayer.mskn file there. over write the one that is there if any. now go in

to the player folder and copy just the player mskn file
and paste it in the same folder you just pasted the floatplayer one in and

over write any player mskn file that might be there..

17. now go in to the different micro players and change or adjust the images

on those. then copy their mskn file from inside their folders and paste them

in the main folder you posted the other player's mskn files in.

18. now open the player ini file change the player size to match the size you changed the main bmp too.
and above that you see the option of resize. change that to read all 0's to

make it a fixed player if you are making it a fixed player.
then save and close the player ini file.

19. now repeat step 18 for the floatplayer ini file.

20. go in to the icons folder you will see the png file in there. that is the no

album art image that shows when there is no album cover for the song

playing. change that to what you want to show if you want to change it at all.

21. now you go in to the theme folder and copy that theme.mskn file
and paste it in the same main folder you just pasted the other player mskn

files in.

22.you are ready for testing the skin.

23.copy the icons folder. and all the ini and mskn files and all the images
in that main folder.

24. go in to the program folder for mm3 in there go in to the skin folder
in there make a new folder call it test.
go in to that test folder and paste the files for your new skin.

25.now open the ini file for the player.

26. now start up media monkey 3 go to tools the options then go to
the skins option on the panels tree and change the skin to the one called
test.
you will see the buttons and the skin and the fonts all do not match or line up.
this is where you use the ini file and change the location / position and the

size of the buttons and text areas one at a time. the size needs to match the
buttons here also.
after you change one or two buttons save the player ini file.
don't close it just save it. now change the player to either the micro

player or the float player. wait 5 seconds or so and restore the main player.
you will see the buttons you change have now moved to the new positions
and sizes. do this for all the buttons and text areas.

27. now you got them perfect then save the player ini file copy the text in the
player ini file. now open the floatplayer ini file and select all the data in there

and paste the data you copied from the player ini file in to the floatplayer ini.
then save the float player ini file you now saved the time and trouble of re
typing the information in to the float player file.

save all ini's you have open. check out the player.
go back and repeat any step and process you need to if you found an error
that you need to fix that is only the errors on the player images.

I would not edit and save the theme file in this new skinning engine it might
mess up the theme features of the mm 2 skin so don't fix any of them errors unless you still have the old version of the skinning engine then you can use it to fix the theme mskn files.

28. now when the skin is to your liking zip the files up including the icons
folder. now go in to that zip file and remove any thumb.ini file that is not
used by the player it is a file only your computer uses..

29. close out of the zip file and rename it with the name of your skin and the
three letter extstion of ".msz" that will be the zipped file the monkey 3 uses.

your skin is complete. enjoy it.

Talk:How to skin MediaMonkey versions 3 and 4

2007-04-06T22:23:48Z

Morten:

here is a FAQ list question for you.

Can I use the Theme engine to change the windows desktop theme aswell as the skin for media monkey?

roving cowboy / keith hall

---

Morten; No, you can't. For that you need a program like WindowsBlinds or to patch your UXTheme.dll.

Skinning (MM4)

2007-04-04T11:48:18Z

Morten: /* Where do I download skins? */

Many skins have been made for MediaMonkey, and the list is getting bigger. MediaMonkey has had the possibility to use Winamp's classic skins, which in theory makes thousands of player skins available for MediaMonkey.

However, with MediaMonkey version 3, there are many new skinning possibilities and more to come.

=== Where do I download skins? ===

There are two categories of skins. The ones made for v2.5 and lower (using Winamp's Player skin), and the new ones made exclusively for MediaMonkey version 3.

'''[[Skins for MediaMonkey v3.0 and higher]]'''

'''[[Skins for MediaMonkey v2.5 and lower]]'''

===How can I make my own skins?===

It's easy to skin when you learn the program which is used (ThemeEditor), but for documentations on how to skin MediaMonkey check these pages;

'''[[How to skin MediaMonkey v3.0 and higher]]'''

'''[[How to skin MediaMonkey v2.5 and lower]]'''

How to skin MediaMonkey v2.5 and lower

2007-04-04T10:48:52Z

Morten: Please keep the wiki free for unneeded images. 32-monkey heads goes under that category

This page is to help you through skinning MediaMonkey 2.

First of all, you need to download ThemeEditor 7.
It's the sameone used on MM 3 Skins it is better then
the older version of the editor and will work on 2.5.5 skins
unlike MM 3 the MM 2.5.5 skin is not able to have multiple players.
and it is only a fixed size skin which means the larger the screen is
the smaller the player skin is.

----

'''[[Roving Cowboy's Explaination for 2.5.5 skinning.]]'''

----

Winamp Plug-ins (MM4)

2007-04-04T10:48:03Z

Morten: Please keep the wiki free for unneeded images. 32-monkey heads goes under that category

== YOUR PLUG-INS Help Page ==

This is for you to add your Help for creation of plug-ins that are used by Media Monkey.
Or for you To put Your Code snipits for others to use in creation of Their plug-ins if
you want to add the general start up or close out code for the plug-ins to cut the coding work down for othes.
Or To help the others learn.
----

'''[[Learning Code Snip-its]]

'''[[Working Codes for addin to your plug-ins]]

'''[[Helpful instructions]]

'''[[Alpha or Beta Codes needing testing]]'''

Skins for MediaMonkey v2.5 and lower

2007-04-04T10:46:18Z

Morten: Please keep the wiki free for unneeded images. 32-monkey heads goes under that category

'''Note: These skins can also be used on MediaMonkey v3. However, on MM3 the player won't be skinned. It Will skin only The List Views '''

{{SkinEntry
|skinname=Aqua
|imageurl=Aqua.gif
|imagedesc=Aqua (Mac OS X 1.5)
|author=DeeLight
|firstreleased=2003-02-26
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Aqua.wsz
|version=1.5
|released=?
|notes=
}}

{{SkinEntry
|skinname=BlackAndRedMonkey
|imageurl=BlackAndRedMonkey.gif
|imagedesc=BlackAndRedMonkey
|author=GodSponge
|firstreleased=2006-12-15
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/BlackAndRedMonkey.wsz
|version=1.0?
|released=2006-12-15
|notes=
}}

{{SkinEntry
|skinname=BlackMonkey
|imageurl=BlackMonkey.gif
|imagedesc=BlackMonkey
|author=Tomasz Zawadzki
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Black%20Monkey.wsz
|version=1.0?
|released=?
|notes=
}}

{{SkinEntry
|skinname=BlueMonkey
|imageurl=BlueMonkey.gif
|imagedesc=BlueMonkey (MediaMonkey Flex)
|author=Find Reality Studios
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Blue%20Monkey.wsz
|version=1.0?
|released=?
|notes=
}}

{{SkinEntry
|skinname=BlueMonkeyRemixed
|imageurl=BlueMonkeyRemixed.gif
|imagedesc=BlueMonkeyRemixed
|author=EAJ
|firstreleased=2005-02-06
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Blue%20Monkey%20Remixed.wsz
|version=1.0?
|released=2005-02-06
|notes=
}}

{{SkinEntry
|skinname=BrushedMonkey
|imageurl=BrushedMonkey.gif
|imagedesc=BrushedMonkey
|author=Trixmoto
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Brushed%20Monkey.wsz
|version=1.6
|released=2005-12-01
|notes=
}}

{{SkinEntry
|skinname=BrushedSteel
|imageurl=BrushedSteel.gif
|imagedesc=BrushedSteel
|author=Bernd Graf
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Brushed%20Steel.wsz
|version=2.1
|released=2005-04-29
|notes=
}}

{{SkinEntry
|skinname=ChristmasToys
|imageurl=ChristmasToys.gif
|imagedesc=ChristmasToys
|author=RovingCowboy
|firstreleased=2005-09-?
|skinurl=http://www.angelfire.com/tx3/rovingcowboy/mediadownloads.html
|version=1.1?
|released=2007-01-?
|notes=
}}

{{SkinEntry
|skinname=DarkGray
|imageurl=DarkGray.gif
|imagedesc=DarkGray
|author=Tommae88
|firstreleased=2005-08-02
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/DarkGray.wsz
|version=1.0?
|released=2005-08-02
|notes=
}}

{{SkinEntry
|skinname=DarkGrayImproved
|imageurl=DarkGrayImproved.gif
|imagedesc=DarkGrayImproved
|author=Tommae88
|firstreleased=2005-08-02
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/DarkGrayImproved.wsz
|version=1.0?
|released=2005-08-02
|notes=
}}

{{SkinEntry
|skinname=GrayMonkey
|imageurl=GrayMonkey.gif
|imagedesc=GrayMonkey
|author=Tommae88
|firstreleased=2005-08-02
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/GrayMonkey.wsz
|version=1.0?
|released=2005-08-02
|notes=
}}

{{SkinEntry
|skinname=iTunes
|imageurl=iTunes.gif
|imagedesc=iTunes
|author=Morten
|firstreleased=2005-08-02
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/GrayMonkey.wsz
|version=1.1
|released=2005-12-03
|notes=
}}

{{SkinEntry
|skinname=JungleMonkey
|imageurl=JungleMonkey.gif
|imagedesc=JungleMonkey
|author=RovingCowboy
|firstreleased=2005-08-?
|skinurl=http://www.angelfire.com/tx3/rovingcowboy/mediadownloads.html
|version=1.1?
|released=2007-01-?
|notes=
}}

{{SkinEntry
|skinname=LightGray
|imageurl=LightGray.gif
|imagedesc=LightGray
|author=Tommae88
|firstreleased=2005-08-02
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/LightGray.wsz
|version=1.0?
|released=2005-08-02
|notes=
}}

{{SkinEntry
|skinname=SoftBlue
|imageurl=SoftBlue.gif
|imagedesc=SoftBlue
|author=Steegy
|firstreleased=2006-12-29
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/SoftBlue.wsz
|version=1.0.2
|released=2006-12-30
|notes=
}}

{{SkinEntry
|skinname=Trucking
|imageurl=Trucking.gif
|imagedesc=Trucking
|author=RovingCowboy
|firstreleased=?
|skinurl=http://www.angelfire.com/tx3/rovingcowboy/mediadownloads.html
|version=1.1?
|released=2007-01-?
|notes=
}}

{{SkinEntry
|skinname=Winamp5
|imageurl=Winamp5.gif
|imagedesc=Winamp5
|author=Steegy
|firstreleased=2006-06-?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/Winamp5.wsz
|version=1.0.4
|released=2007-01-07
|notes=
}}

{{SkinEntry
|skinname=XPBlue
|imageurl=XPBlue.gif
|imagedesc=XPBlue
|author=Ventis Media with contributions from KSdev & Kerem Erkan
|firstreleased=2001-06-30
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/XP%20Blue.wsz
|version=7
|released=?
|notes=
}}

{{SkinEntry
|skinname=XPMetallic
|imageurl=XPMetallic.gif
|imagedesc=XPMetallic
|author=Ventis Media with contributions from KSdev & Kerem Erkan
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/XP%20Metallic.wsz
|version=1?
|released=?
|notes=
}}

{{SkinEntry
|skinname=XPOlive
|imageurl=XPOlive.gif
|imagedesc=XPOlive
|author=Ventis Media with contributions from KSdev & Kerem Erkan
|firstreleased=?
|skinurl=http://home.scarlet.be/ruben.castelein/MM/files/XP%20Olive.wsz
|version=1?
|released=?
|notes=
}}

Skins for MediaMonkey v3.0 and higher

2007-04-04T10:45:19Z

Morten: Please keep the wiki free for unneeded images. 32-monkey heads goes under that category

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

'''Listed Below are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.'''

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

== Skinning Authors with More then 2 Skin Screenshots ==

== Rovingcowboy's skins ==

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
'''[ all downloads are at my site]

'''[[Roving Cowboy's MM 3_ScreenShots]] |''' [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]'''

==Default Skin Recolored==
'''by Blakeloth and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

Skins for MediaMonkey v3.0 and higher

2007-04-04T10:44:54Z

Morten: Please keep the wiki free for unneeded images. 32-monkey heads goes under that category

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

'''Listed Below are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.'''

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

[[Image:MonkeyBar.gif]]

== Skinning Authors with More then 2 Skin Screenshots ==

== Rovingcowboy's skins ==

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
'''[ all downloads are at my site]

'''[[Roving Cowboy's MM 3_ScreenShots]] |''' [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]'''

==Default Skin Recolored==
'''by Blakeloth and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

Tips & Tricks

2007-04-04T10:41:38Z

Morten:

'''
This page is for tips that make things easy or that are not known by new computer users.
in other words some tips that were from older windows os's that still work on winXp or newer versions of windows.'''

'''[[ Icons tips ]]

'''[[ Song Recording Tips ]]

'''[[ Song Editing Tips ]]

'''[[ System Hardware Tips]]

'''[[ MISC... Tips ]]'''

Skinning (MM4)

2007-04-04T10:40:01Z

Morten: Please keep the wiki free for unneeded images.

Many skins have been made for MediaMonkey, and the list is getting bigger. MediaMoney has had the possibility to use Winamp's classic skins, which in theory makes thousands of player skins available for MediaMonkey.

However, with MediaMonkey version 3, there are many new skinning possibilities and more to come.

=== Where do I download skins? ===

There are two categories of skins. The ones made for v2.5 and lower (using Winamp's skinning module), and the new ones made exclusively for MediaMonkey version 3.

'''[[Skins for MediaMonkey v3.0 and higher]]'''

'''[[Skins for MediaMonkey v2.5 and lower]]'''

===How can I make my own skins?===

It's easy to skin when you learn the program which is used (ThemeEditor), but for documentations on how to skin MediaMonkey check these pages;

'''[[How to skin MediaMonkey v3.0 and higher]]'''

'''[[How to skin MediaMonkey v2.5 and lower]]'''

Skins for MediaMonkey v2.5 and lower

2007-04-04T10:38:43Z

Morten: Please keep the wiki free for unneeded images.

Skins for MediaMonkey v3.0 and higher

2007-04-04T10:38:04Z

Morten: Please keep the wiki free for unneeded images.

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

'''Listed Below are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.'''

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-02-25

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired by WMP and it feels more like the original MediaMonkey skin. There are two versions available: The blue version (original) and the green version as shown in the screenshot

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-03-02

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

[[Image:MonkeyBar.gif]]

== Rovingcowboy's skins ==

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
'''[ all downloads are at my site]

'''[[Roving Cowboy's MM 3_ScreenShots]] |''' [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]'''

==Default Skin Recolored==
'''by Blakeloth and by Tommae88'''

'''[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

'''[[Re - Colored Screenshots]]'''

[[Image:MonkeyBar.gif]]

User:Morten

2007-04-03T17:03:40Z

Morten:

I'm mainly a skinner, but please ask me if you have questions.

How to skin MediaMonkey versions 3 and 4

2007-04-03T17:01:37Z

Morten: /* FAQ */

Skins for MediaMonkey v3.0 and higher

2007-04-03T15:04:57Z

Morten: /* Red Bruise */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

File:WMP11 m.jpg

2007-04-03T14:57:54Z

Morten: Alpha 4-version of the skin.

Alpha 4-version of the skin.

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:56:27Z

Morten: /* WMP11 */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_m.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

----

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:52:31Z

Morten: /* Tommae88's skins */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
===Red Bruise===

[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:48:44Z

Morten: /* iTunes 7 */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

==Tommae88's skins==
[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:48:32Z

Morten: /* Tommae88's skins */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

----

==Tommae88's skins==
[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:48:23Z

Morten: /* Monkey11 */

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

----

==Tommae88's skins==
[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

----

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:48:03Z

Morten:

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

----

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

----

==Tommae88's skins==
[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

----

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

File:Red bruise.jpg

2007-04-03T14:46:45Z

Morten:

Skins for MediaMonkey v3.0 and higher

2007-04-03T14:46:07Z

Morten: Edited the image as you said Rovingc.

Listed under are some skins for MediaMonkey v3.0 which currently is in the alpha stages. You may need to right click and use the "Save link as" option in your internet browser.
----

==Blakeloth's skins==
===Monkey11===
[[Image:WMP11_blakeloth.jpg|right|thumb|300px|Blakeloth's WMP11 look-a-like]]

'''Author:''' [[User:Blakeloth1|Blakeloth]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?cjzxzjjmx2h Download #1] | [http://lajevardi.googlepages.com/Monkey11.msz Download #2] | [http://lajevardi.persiangig.com/app/mm.v3.0/Monkey11.msz Download #3] (v?.? - 2007-0?-??)

'''Notes:''' This skin is more inspired of WMP and it feels more like the original MediaMonkey skin.

<br clear="all" />

----

==Morten's skins==

===WMP11===
[[Image:WMP11_1.jpg|right|thumb|300px|Morten's WMP11 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=139130 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like Windows Media Player v11 as much as possible. Some usability enhancements are made that are not available in WMP11 itself.

<br clear="all" />

===iTunes 7===
[[Image:ITunes_morten.jpg|right|thumb|300px|Morten's iTunes 7 skin for MM3]]

'''Author:''' [[User:Morten9300|Morten]]

'''First released:''' 2007-01-26

'''Current version:''' [http://www.diskusjon.no/index.php?act=Attach&type=post&id=135227 Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin tries to look like ITunes v7 as much as possible. Some usability enhancements are made that are not available in ITunes7 itself.

<br clear="all" />

----

==Tommae88's skins==
[[Image:Red_bruise.jpg|right|thumb|300px|Tommae88's Red Bruise skin]]

'''Author:''' [[User:Tommae88|Tommae88]]

'''First released:''' 2007-01-??

'''Current version:''' [http://www.mediafire.com/?1nvhvvimmmz Download] (v1.2 - 2007-01-28)

'''Notes:''' This skin has a nice red quality over itself and is based on the default theme.

<br clear="all" />

----

==Rovingcowboy's skins==

[http://www.mediamonkey.com/forum/viewtopic.php?p=27829#27829 For More About My Media Monkey Items Read This Forum Thread]
[ all downloads are at my site]

[[Roving Cowboy's MM 3_ScreenShots]] | [http://www.angelfire.com/tx5/rovingcowboy/msagentsongs.html#Skins MM 3 DownLoads]

----

==Default Skin Recolored==
by Blakeloth and by Tommae88

[http://www.mediamonkey.com/forum/viewtopic.php?p=78163#78163 the default royal blue, in modified colours Download links] |

[[Re - Colored Screenshots]]
----
----

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:40:10Z

Morten:

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the '''main''' skinning page'']

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:39:49Z

Morten:

[http://www.mediamonkey.com/wiki/index.php/Skinning ''Go back to the skinning page'']

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:39:04Z

Morten:

[http://www.mediamonkey.com/wiki/index.php/Skinning <--- Go back to the skinning page]

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:38:39Z

Morten:

[[Skinning <--- Go back to the skinning page]]

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:36:55Z

Morten: /* Edit advanced backgrounds for your player */

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Make advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.

How to skin MediaMonkey versions 3 and 4

2007-04-03T14:33:34Z

Morten: /* Edit your first entry in the ini-file */

This page is to help you through skinning MediaMonkey and it's objects.

First of all, you need to download [http://www.mediamonkey.com/contrib/artwork/themeeditor7.exe ThemeEditor 7]. It's required to edit the [[.mskn-files]] which MediaMonkey uses to draw windows, objects, text etc. There'll be three categories; one for the .player-skins, one for the big ol' "Theme.mskn" and one for the other objects which also is customizable. We'll start with the player-skins.

----
===Player-skins===
Player-skins is defined by two files; the .mskn- and the ini-file. They have same names, but different extensions. There are three types of players; Player, FloatPlayer, MicroPlayer.

'''Player''' is for the player skin when the monkey is maximized with all functions activated. It can not be transperent.

'''FloatPlayer''' is for the mini-player skin which can be transperent.

'''MicroPlayer''' is for the tray-area in Windows. This is mainly a control-skin, but there are indications that it'll be extended to show album-information when you activate a button in the tray-player.

==Guided skinning of Player- and FloatPlayer-skin==
When you've downloaded ThemeEditor, you're ready to go. However, you must have a resource file (.PNG, .BMP, .ICO, .EMF or a .WMF-file) to retrieve images for elements in your skin from. You have the possibility to;

'''a)''' Work from an existing skin-file.
'''b)''' Start from scratch.

This guide will let you do both things. It will also guide you through skinning both the Player-skin and the FloatPlayer-skin. However, the one big difference is that the Player-skin can't be transperent. Elements in it can be transparent just as with the MiniPlayer-skin, but it's main purpose is to be docked inside the MediaMonkey-window, so it needs to be a box with four sides.

Let's begin. Always begin with the .mskn-file. It defines the resources you want to use in your skin. The ini-file is mainly for positioning and sizing of the elements.
----
===Defining the background for your player===

Make yourself a folder with your skin's name. Put it inside your 'X:\Program Files\MediaMonkey\Skins\'-folder. Open up ThemeEditor 7, or open up an existing .mskn-file. In either case, go up to the menu and press 'Save as'. Go the new folder you've created and name the file either Player.mskn or FloatPlayer.mskn. The new file you've just saved will have an element called 'Form'. This you can use in your skin but rename it first to 'PlayerBackground'. This element is shown with the number 1 in the help-image. Next up, define the element's Width and Height. The 'Width'-entry is placed furthest down on any element in the .mksn-file, and the 'Height'-entry is easily found above the entry named 'Kind'. Now, check that the 'Kind'-entry has this property: "'''skNone'''". If you've made a new file, it will be "skForm". The last thing we want to do with this element is making it a client for your skin. It is important to define this as client, because it's a container (wrapper) of all your skin's background. Change the first entry 'Align' to "'''saClient'''".

'''Next up''' is learning to use image-elements. Press on the newly made element 'PlayerBackground' and thereafter press on Bitmap Object (1 state). This is shown with the number 2 in the help-image. When you've pressed that, the container will get a "+"-sign to signalise it has elements inside itself. The image-element you've just made will have a height of 20px and a width of 30px. Define it as big as you like. If you don't know how big the element is, and that's not unlikely at all, define the image source first. This entry called 'Bitmap' (shown with the number 3 in the help-image) is the only source for this entry. It's not a 5-state button, so it's easy to define.

Before we proceed, there is important to know that this background image should be resizable, at least if you're making a Player.mksn-file. To have a nice stretching of your background-image, you must have something that you want to be dragable and something you don't. If you want all elements in your background to stretch, skip the next paragraph;
----
===Edit advanced backgrounds for your player===
First, we need to define what should be stretchable and place the un-stretchable element on top of that. This is very easy. Do you remember the 'Align'-entry? This entry is one of the most important entries in your .mskn-file. If you don't want the element to be resizable, you need to position the element relative to either the center "'''saCenter'''", the left side "'''saLeft'''" or the right side "'''saRight'''". It's important that you do this, so that the element knows where it should be when the player is resizing.

In our example, we want our skin to have a Left- and a Right-side which isn't stretchable, and a mid-part which is. We've just added a one-state Bitmap Object. We need two more. For each time you want to make a sub-element, you've got to select which element that should have this. In our case it's always the PlayerBackground which has to have sub-elements. When we want other player-elements such as Play/Pause-buttons, Continous etc. we have to press the objects-node and thereafter make a new image-element. The left element can be our first element. It should have the same height as the container, but it should be less wider. Define what part of the Bitmap which should be used as the source for this part and writ down how wide this element is. You'll need it for your Stretch-part. Next up is the Right-part of the skin. Instead of defining the entry 'Align' as "saLeft", define it as "saRight". most likely it will have the same height as the container, and the same width as your left part.

Now what's left is the stretch part. The most important thing to notice is that this part's entry 'Align' should have the property "'''saClient'''", just as the container has. Do you remember the number you wrote down for some minutes ago? Use this number in the element's 'Left'-entry. When you've defined this elements width, you'll have to summen up the width of this element and the Left-side of the player to use on positioning the Right-element. Use the same entry 'Left' to position the element. If you press on the PlayerBackground node, you'll now see a nice player-background to work with.

----

===Edit your first entry in the ini-file===

'''Note: Everybody should read the next part.'''

You'll have to make an ini-file. It must have the same name as your mskn-file, but it must have the .ini-extension instead of the .mskn-extension. To edit this ini-file, simply select Notepad to open this in Windows.

<source lang="csharp">
[PlayerSkin]
EngineVersion=100
Resizable=1,1,1,0
Pos=0,0
Size=675,60
Transperent=0
TimeFormat=mmm:ss
</source>

This code should be similar to your first entry in the ini-file. It says how small the player can be and how it resizes. Ignore the EngineVersion. You don't modify that. The "'''[]'''" says for what skin-element the following code is for. We'll go through that later. Just know that the first entry should be [PlayerSkin] and the information you should be editing is this.

'''1) Resizable''' - This tells the engine in what directions you can resize to, but also where the elements in your skin should be oriented by. This is a usual code for a player skin which can, in fact, only be resized horisontally. The number '''1''' enables (in order) resizing "'''Left,Top,Right,Bottom'''", and the number '''0''' deactivates that type of resizing.

'''2) Pos''' - Positioning of elements is usual, so leave this thing alone. We will go through what it's for very soon.

'''3) Size''' - This defines the smallest size of your player skin. It's important that you make this area as small as possible. The values are for the size "Width, Height" in pixels (px).

'''4) Transperent''' - Is a very important point. For player-skins used in the main body, this isn't supported. But for '''FloatPlayer''' this is very useful to make weird formed player skins. As with the other elements, the number '''1''' activates this function.

==Main Theme (Theme.mskn)==
More information to be added.

===Other objects===
On the to-do list of the MediaMonkey-team is wrapping of icons within the [[.msz-file]].

==FAQ==
If you get any more questions, please ask and it will be put in here.