Skin sections
Skin sections in Rainmeter.ini (e.g. [illustro\Clock]
) define options for how the skin is loaded and displayed in Rainmeter.
The skin is defined in Rainmeter.ini using the Config name.
Options
Active
-
The current active state of the config. If Active is
0
, the config is inactive. If a number other than 0, the active skin .ini or variant is the file in alphabetical order in the config folder. WindowX
,WindowY
-
The X and Y position of the skin. The value is in pixels.
A trailing
%
sign indicates that the value is a percentage of the screen width, rather than pixels.WindowX=50%
A trailing
R
withWindowX
will make the position relative to the right edge of the screen instead of the left.A trailing
B
withWindowY
will make the position relative to the bottom edge of the screen instead of the top.WindowX=100R
WindowY=50B
The
%
andR
/B
modifiers can be used together.WindowX=20%R
Both
WindowX
andWindowY
will accept formulas.
The formula must be enclosed in (parenthese), with any trailing% / R / B
at the end, and outside the (parentheses).WindowX=(100 / 2)%
By default the position is relative to the primary screen. You can override this with
@N
where N is 0 to 32 and denotes which screen to position the skin on (1-32) or the virtual desktop (0). The screen selection will apply to bothWindowX
andWindowY
if the value is set on only one of them.WindowX=200@2
AnchorX
,AnchorY
-
By default
WindowX
andWindowY
control the position of the upper left corner of the config window.AnchorX
andAnchorY
allow that anchor position to be changed. The value is in pixels.A trailing
%
sign indicates that the value is a percentage of the config window width, rather than pixels.AnchorX=50%
A trailing
R
withAnchorX
will make the position relative to the right edge of the config window instead of the left.A trailing
B
withAnchorY
will make the position relative to the bottom edge of the config window instead of the top.AnchorX=100R
AnchorY=50B
The
%
andR
/B
modifiers can be used together.AnchorX=20%R
Both
AnchorX
andAnchorY
will accept formulas.
The formula must be enclosed in (parenthese), with any trailing% / R / B
at the end, and outside the (parentheses).AnchorX=(100 / 2)%
As an example, by setting
WindowX
,WindowY
,AnchorX
andAnchorY
all to 50% the config will be truly centered in the primary monitor regardless of screen resolution or aspect ratio. SavePosition
Default:1
-
If set to
1
, changes to the window position will be saved to Rainmeter.ini. AlwaysOnTop
Default:0
-
Defines the Z-position (front to back) of the skin. Valid values are:
2
: Stay Topmost. The skin will stay visible when showing the desktop {Win-D} and will actively stay on top of all other windows including other skins. Two Rainmeter skins both set to Stay Topmost should not overlap, as this creates a conflict, and they will "flicker". LoadOrder has no effect with this setting.1
: Topmost. The skin will stay visible when showing the desktop {Win-D} and stay on top of other normal application windows. Two Rainmeter skins both set to Topmost will change relative to each other on click. Overlapping skins with the same setting can use LoadOrder to control the initial relative position.0
: Normal. The skin will stay visible when showing the desktop {Win-D} and will be brought to the foreground of all other normal windows, including other skins, on click. Overlapping skins with the same setting can use LoadOrder to control the initial relative position.-1
: Bottom. The skin will not stay visible when showing the desktop {Win-D} and stay behind other normal application windows. Two Rainmeter skins both set to Bottom will not change relative to each other on click. Overlapping skins with the same setting should use LoadOrder to control relative position.-2
: On Desktop. The skin will stay visible when showing the desktop {Win-D} and stay behind other normal application windows. Two Rainmeter skins both set to On Desktop will not change relative to each other on click. Overlapping skins with the same setting should use LoadOrder to control relative position.
Note: If another application window explicitly sets itself to "top" after a skin set to Topmost is loaded, the application window will be in front until the skin is clicked or refreshed. Using Stay Topmost can overcome this, but again, you must not have two skins set to Stay Topmost that overlap.
Draggable
Default:1
-
If set to
1
, the skin can be dragged around with the mouse. SnapEdges
Default:1
-
If set to
1
, the skin will snap onto screen edges and other skins when moved. To disable snapping temporarily, hold the CTRL key down while moving the skin. StartHidden
Default:0
-
If set to
1
, the skin will start hidden. The !Show bang must be used to show the skin. AlphaValue
Default:255
-
Sets the transparency of the skin. Valid values range from
0
(fully transparent) to255
(fully visible).Note: A setting of
0
(fully transparent) will not allow detection of the mouse on the skin, and the OnHover option will have no effect. To have a skin be invisible but react to the mouse, a minimum setting of1
should be used here. When changed using theTransparency
setting in the Manage interface, a range of percentages is offered, but corresponding numeric values are stored. OnHover
Default:0
-
Controls the transparency of the skin when the mouse is moved on and off of it. This works in conjunction with the setting in AlphaValue. This can be also be set with the
On hover
setting in the Manage interface. To temporarily disable this behavior, hold CTRL down when moving the cursor.0
(Do Nothing - default) : No action is taken.1
(Hide) : Skin will fade between the value inAlphaValue
and hidden. If noAlphaValue
is defined, it will simply fade between fully visible and hidden.2
(Fade in) : Skin will fade between the value inAlphaValue
and fully visible.3
(Fade out) : Skin will fade between the value inAlphaValue
and hidden.
FadeDuration
Default:250
-
Defines the length of the fade duration in milliseconds when OnHover is used, activating/deactivating the skin, or when the fade bangs are used.
ClickThrough
Default:0
-
If set to
1
, all mouse over detection is disabled, and mouse clicks will pass through the skin. To temporary disable this, hold the CTRL key when interacting with the mouse. KeepOnScreen
Default:1
-
If set to
1
, the skin will be kept within the bounds of the screen. LoadOrder
Default:0
-
Determines the order in which the skins are loaded. The value can be any number (even negative). Skins with the lowest load order are loaded first.
Example: Three skins having
LoadOrder=-1
,LoadOrder=2
andLoadOrder=5
would load the configs in that order, with the config withLoadOrder=-1
appearing beneath the one with LoadOrder=2 which is in turn beneath the config containingLoadOrder=5
. If two configs have the same value for LoadOrder, they are then loaded in the order they are in Rainmeter.ini.Note: The value of LoadOrder has no bearing on the Z-position of the skin. LoadOrder only affects how skins in the same Z-position interact with each other. That is to say, configs set to "Topmost" will always appear above configs set to "Normal", but two configs in "Topmost" will layer themselves according to their LoadOrder value.
AutoSelectScreen
Default:0
-
If set to
1
, the WindowX/WindowY "@N" settings are dynamically set based on the position of the meter's window. This setting will reset to 0 when a monitor is selected in the Manage window or on the skins context menu. Group
-
Defines a group or series of groups that the skin belongs to. For more information please see the Groups page.
DragGroup
-
A group or series of Drag Groups that the skin belongs to. So if any skin is selected, any skins in the same DragGroup will automatically be selected as well.