Version 4 (modified by Olemis Lang, 11 years ago) (diff)

MacTheme config options

Themes for Trac based on MacOS appearance


This is a theme that emulates the look of (some versions of) Mac OS (and YES it has an apple ;o) .

It requires the ThemeEnginePlugin and provides the following features.

  • Dock navigation ... like in the Mac !!! It's behavior may be customized using config options
  • Fixed (collapsible) toolbar at the bottom containing mainnav items
  • Fixed ctxtnav items at the top
  • Fixed metanav items at the top
  • Fixed drop down menu containing mainnav items
  • Controls the size of nav bars by placing extra nav items inside drop-down menus.
  • Pretty-fication (IOW lovely icons :P)
  • Mac-like styles (progress bars, ...)
  • Active request handler highlighted
  • more ...


Once the theme is installed and selected, it looks like this

Mac OS theme screenshot

Configuration options in trac.ini


coefficient Attenuation coefficient. This controls the relationship between the distance from the cursor and the amount of expansion of any affected image within that distance. A coefficient of 1 makes the expansion linear with respect to distance from cursor; a larger coefficient gives a greater degree of expansion the closer to the cursor the affected image is (within distance).
default Catch-all image in dock menu.
distance Attenuation distance from cursor, ie the distance (in pixels) from the cursor that an image has to be within in order to have any expansion applied. Note that attenuation is always calculated as if the Dock was 'at rest' (no images expanded), even though there may be expanded images at the time.
duration The duration (in milliseconds) of the initial 'on-Dock' expansion, and the 'off-Dock' shrinkage.
fadeIn The amount of time (in milliseconds) for the initial fade-in of the Dock after initialisation. By default this is set to 1000, which means that the Dock is displayed in full 1 second after it's initialized. Set this value to 0 (zero) to remove the effect.
fadeLayer By default the fade-in effect is applied to the original target menu element. By specifying either 'wrap' or 'dock' here, the fade-in element can be switched to the child or grand-child of the original target menu element. This option only has any effect if fadeIn is set, and is really only useful for cases where, for example, background colours have been styled on the original menu element and you don't want them to be faded in.
images Images rendered in dock menu.
inactivity The period of time (in milliseconds) after which the Dock will shrink if there has been no movement of the mouse while it is over an expanded Dock. Set to 0 (zero) to disable the inactivity timeout .
labels This enables/disables display of a label on the current image. Allowed string values are 2 characters in length: the first character indicates horizontal position (t=top, m=middle, b=bottom) and the second indicates vertical position (l=left, c=center, r=right). Default is 'tl' (i.e. labels shown in top-left corner). Please be aware that enabling this option with one of the middle/center label positions (eg. 'ml', 'bc', etc) may have a slight effect on the performance of the Dock, simply due to the additional processing required to position the label correctly. Hide labels by leaving this option empty.
step The timer interval (in milliseconds) between each animation step of the 'on-Dock' expansion, and the 'off-Dock' shrinkage.


tbcount Number of fixed items in toolbar

Bugs/Feature Requests

Existing bugs and feature requests for MacTheme are here.

If you have any issues, create a new ticket. If you want to submit patches, please read the patch submission guidelines.


Download the zipped source from here.


You can check out MacTheme from Simelo's project repository or from its Bitbucket repository using Mercurial. Besides you can browse the source (not with with Trac, sorry :-/ ) .


To enable:

tracmacos.* = enabled

To use:

theme = MacOS

Recent Changes

17940 by rjollos on 2020-12-23 22:58:53
Code drop from PyPI


Author: olemis
Maintainer: olemis
Contributors: Yelian


The plugin uses images found in Mac4Lin and Albook extended icon sets, as well as other Creative Commons sources (mostly from deviantart ... e.g. the red & gray Finder ;o) , so I thank them all for their dedication while creating all those amazing pictures ...

... and thnx to all those that actively enhance(d) jqDock jQuery plugin . Thnxxxxx very much !!!

Attachments (1)

Download all attachments as: .zip