A few parts of gmb can be skinned, though I never completely finished this, some nice things can be done with the current system.
A skin is defined by adding some properties to some of the widgets in a layout definition. (note that I wrote this system long ago, so I may have made some mistakes in the documentation)
Only 3 type of widgets have a skin option :
Note that I tried to make a system that allow the skin to be resized. But it is not an obligation, you can use FB boxes to put widgets at a fixed position (relative to the FB box), for example :
FBButtons = 30,20 Prev \ 30,40 Play \ 30,60 Next
The skin options are strings separated by ”:” of the format : filename:crop:resize
means the picture in paper_PosBack.png is to scaled by stretching it horizontally, it won't be resized vertically (i think it will be centered if needed)
defines a skin with a top border of 18px, a bottom of 20px, left of 8px and right of 20px, all parts will be repeated if needed
For buttons, there can be 2 other options:
Note: after v1.1.6, the modes of the play button have been renamed to
for example, this play button
need 6 versions, so the picture will be divided in 6 parts horizontally.
The Scale widget (or the TimeBar widget in 1.0.x) uses the 'skin' option for its background, and the 'handle_skin' option for its handle. As the buttons, the 'handle_skin' option may specify different states :
specify a skin for the handle with 3 states : normal, prelight and active
[paperskin] Type=G Default = Window ontop=1,sticky=1,nodecoration=1 SkinPath = testskin Skin = paper4.png::s HBTime = LabelTime Length _Scale(skin=paper_PosBack.png::hs,handle_skin=paper_PosHand.png:::normal_prelight_active) HBTitle = Filler0 _Title HBArtist = LockArtist _Artist HBAlbum = LockAlbum _Album -Date VBText = HBTitle HBArtist HBAlbum DefaultFont = Babelfish 14 HBButtons = 50Filler1 \ 5Playlist(skin=paper_Eject.png:::normal_prelight_active) \ 5Prev(skin=paper_Prev.png:::normal_prelight_active) \ 5Stop(skin=paper_Stop.png:::normal_prelight_active) \ 5Play(skin=paper_PlayPause.png:::normal_prelight_active:Play_Paused) \ 5Next(skin=paper_Next.png:::normal_prelight_active) VBmain = _VBText _HBButtons _HBTime FBmain = .18,.25,.61,.49 VBmain HSize0 = Filler0 LockArtist LockAlbum VolumeScroll = VBmain
This is a not-very-good attempt at a skin I've made at the time.
It is meant to more or less reproduce the paper skin of gqmpeg : http://gqmpeg.sourceforge.net/mpeg-skin2.html#SEC5 (some of the pictures come from it)
To use it, you have to put the layout file in :
and put the .png files in
(or you can change the SkinPath= in the layout file)
If you use the v1.1.x branch, you should replace Scale by TimeBar in the layout file, else the time bar won't be skinned.
Also, unless you remove the nodecoration=1 in the layout file, it won't have any window decoration, so you'll have to use alt-leftclick to move the window, and alt-middleclick to resize it (unless your window manager use different shortcuts for that). (moving the window by just clicking on an empty part of the background is currently only implemented in the current git version by using the dragtomove=1 window option)
You can change the default font that will be used by Title/Artist/… by changing the DefaultFont= option