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. A trailing % sign indicates that the value is a percentage of the screen width. A trailing R will make the position relative to the right edge of the screen instead of the left. A trailing B will make the position relative to the bottom edge of the screen instead of the top.

The % and R / B modifiers can be used together.

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 both WindowX and WindowY if the value is set on only one of them.

AnchorX, AnchorY

By default WindowX and WindowY control the position of the upper left corner of the config window. AnchorX and AnchorY allow that anchor position to be changed. The Anchor can be defined in pixels from the upper left corner of the window or as a percentage of the config if % is used. If a letter R or B is added to AnchorX or AnchorY, then the position is relative to the right or bottom edge of the window.

As an example, by setting WindowX, WindowY, AnchorX and AnchorY 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 of the skin. Valid values are:

  • 2: Always on top. The skin will be on top of all (including topmost) windows.
  • 1: On top. The skin will be on top of normal windows.
  • 0: Normal. The skin will stay visible when showing the desktop and will be brought to the foreground on click.
  • -1: Bottom. The skin will stay behind other windows.
  • -2: On desktop. Similar to 0 except that the skin will stick to the desktop and cannot be brought to the foreground.

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) to 255 (fully visible).

Note: A setting of 0 (fully transparent) will not allow detection of the mouse on the skin, and the HideOnMouseOver option will have no effect. To have a skin be invisible but react to the mouse, a minimum setting of 1 should be used here. When changed using the Transparency setting in the Manage interface, a range of percentages is offered, but corresponding numeric values are stored.

HideOnMouseOver 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 in AlphaValue and hidden. If no AlphaValue is defined, it will simply fade between fully visible and hidden.
  • 2 (Fade in) : Skin will fade between the value in AlphaValue and fully visible.
  • 3 (Fade out) : Skin will fade between the value in AlphaValue and hidden.
FadeDuration Default: 250

Defines the length of the fade duration in milliseconds when HideOnMouseOver is used, activating/deactivating the skin, or when the fade bangs are used.

ClickThrough Default: 0

If set to 1, mouse clicks will pass through the skin. To temporary disable this, hold the CTRL key when clicking.

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 and LoadOrder=5 would load the configs in that order, with the config with LoadOrder=-1 appearing beneath the one with LoadOrder=2 which is in turn beneath the config containing LoadOrder=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.