The [Rainmeter] section of a skin defines options for the entire skin.
Defines the update interval of the skin in milliseconds. On each update, meters and measures are updated.
-1will update the skin only once on load (or on refresh). The skin can then be manually updated using the !Update bang.
Note: Update is not related to the system clock, and if a computer is busy or a complicated skin takes longer than the interval to complete a full update of the skin, updates can be unreliable in relation to elapsed time. Do not use the Update value to drive clocks or other timing sensitive functions.
If set to
1, String meters are measured and rendered using improved padding and character spacing similar to that provided by Direct2D.
If set to
1, the window size is adjusted on each update to fit the meters.
Uses 4 values separated by commas to define the area from where the window can be dragged. The values define a margin of non-draggable area. It's also possible to use negative numbers in which case the margin is calculated from the opposite side. E.g.
Action to execute when the skin is loaded or refreshed.
Action to execute when the skin is unloaded or when Rainmeter is closed.
Action to execute when the skin recieves focus in Windows (set by clicking the mouse on the skin).
Action to execute when the skin loses focus in Windows.
Action to execute when Windows returns from the sleep or hibernate states.
Defines the update time in milliseconds for meter transitions. While a transition is active the meter will update at this rate. Currently, only the Bitmap meter supports meter transitions.
If set to
1, all tooltips in the skin will be hidden. More information on tooltips.
- General image options
All general image options are valid for
Tile, which is handled with
Path of a background image file.
Defines the background mode for the skin. Valid values are:
0: Image as defined by
1: Transparent background
2: Fill with a solid color
3: Fill by scaling image as defined by
4: Fill by tiling image as defined by
BackgroundMode=3, defines margins of the
Backgroundimage that are not scaled. The parameters are
10 pixels from the top and 20 pixels from the bottom of the image are not scaled.
SolidColor=0,0,0,1can be used to make transparent areas of the background clickable.
Angle of the gradient in degrees (for
If enabled, draws a bevel around the edges of the entire skin when
BackgroundMode=2. Valid values are:
0: No bevel
If not blank, adds an item to the skin's context menu under "Custom skin actions". Up to 15 ContextTitleN options are allowed, with up to 30 characters per option. Additional characters are truncated with an ellipsis (
...). If more than 3 ContextTitleN options are given, "Custom skin actions" becomes a submenu. If a ContextTitleN option is not valid, all subsequent ContextTitleN options are ignored. In addition, if more than 3 options are given, and the value of ContextTitleN includes only dashes (
-), the item is displayed as a separator.
Note: Variables in
ContextTitleNare always dynamic. Variable values are read at the time the context menu is opened.
Note: Variables in
ContextActionNare always dynamic. Variable values are read at the time the context menu item is clicked.
Aero Blur options
Set to 1 to enable Aero Blur on Windows Vista or Windows 7 operating systems. If no BlurRegions are specified, the entire skin background is blurred. Note that Windows 8 has removed this capability.
BlurRegion, BlurRegion2, ..., BlurRegionN
Defines areas and shapes of the one or more regions of the skin to be blurred. The format of the option is:
BlurRegion=Type, TopX, TopY, BottomX, BottomY ,Radius.
Valid values for
0: Region is disabled
1: Rectangular region
2: Rectangular region with rounded corners (requires
3: Elliptical region
The parameters following
Typedefine the size and shape of the region. They are, in order:
TopX: Top left horizontal point in the skin
TopY: Top left vertical point in the skin
BottomX: Bottom right horizontal point in the skin
BottomY: Bottom right vertical point in the skin
Radius: Radius of the corners of rounded rectangles (required for
Note: Aero Blur options can be dynamically controlled with several bangs.
[Rainmeter] Update=1000 Blur=1 BlurRegion=1,10,10,190,50 ; BlurRegion creates a rectangle starting at 10 pixels from the left, 10 pixels down from the top, and ending at 190 pixels to the right, 50 pixels from the top. BlurRegion2=3,10,70,80,110 BlurRegion3=2,10,130,190,170,15 [Background] Meter=Image W=200 H=180 SolidColor=0,0,0,50 LeftMouseUpAction=[!AddBlur "1,0,0,200,80"]
The author of the skin.
Note: This option is deprecated. Author should be defined in the [Metadata] section of the skin.
Defines the minimum version of Rainmeter required to use the skin. The formula to calculate the value is:
major * 1000000 + minor1 * 1000 + minor2.
Note: This option is deprecated. Use the version capabilities in Skin Packager.
Loads the specified TTF font files for use with FontFace in String meters.
Note: This option is deprecated. Use the @Resources\Fonts folder instead.