![]() |
Themes |
You can create custom dock themes for DockShelf by following this guide. You will need to have basic skills editing graphics (in Photoshop for example) and the ability to read/edit XML property list files using a GUI edtior or any text editor.
Contents
Dockshelf themes are bundles, which are folders with a special extension (in this case .dstheme) which make them appear as files in the Finder. To edit a .dstheme file right-click on the file and choose "Show Package Contents" from the popup menu.
To create a new theme it's recommended to duplicate the default theme (found in DockShelf.app/Contents/Resources/Themes/Default.dstheme
) but you can also make a new folder and add all the files as described below then rename with the extension .dstheme.
User created themes should be saved in ~/Library/DockShelf/Themes
to be available in DockShelf. If you would like to make a theme public please send the file to info@dockshelf.com for consideration.
Theme bundles must contain the following files/folders:
Background | This folder contains a 9-part image which forms the background. Each file must in .png format, of equal size and square (i.e. all files must 32x32 pixels) and be named properly (refer the default theme). |
info.plist | The theme property file (see below for full description). |
process_indicator.png | An image displayed to the side of application items when the application is open. |
separator_horizantal.png | The horizantal separator image. |
separator_vertical.png | The vertical separator image. |
Each theme contains an info.plist XML property list which contains various properties specific to the theme.
colorInset | Inset of the colored rounded rectangle which will be drawn over the background. |
contentMargin | Margin of the dock items from the background edge. |
dragMargin | Margin around the dock items icon for clicking/dragging. |
font | Font to use for the dock title. |
frameInset | Inset around the entire dock to provide extra space for shadows. |
interiorInset | Inset of the interior backgroud frame (the portion without border, if this exists in the theme). |
itemMargin | Margin between items. |
itemScreenMargin | Margin between items against the edge of the screen they are positioned by. |
opacity | Default opacity of the background image. |
radius | Radius of the backgroud image corners (for apply color overlays). |
screenOverlap | The amount of pixels to overlap the screen when the dock is auto-hiding. |
shadowBlur | Blur (in pixels) of the shadow. |
shadowOffset | Offset of the shadow. |
tabOffscreenMargin | The amount of pixels offscreen the dock is drawn when showing as a tab. |
titleEdgePadding | Padding around the title on non-screen edges. |
titleScreenPadding | Padding around the title on the edge nearest the screen edge. |
titleOffset | Offset of the dock title. |