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 (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) 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, 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 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.