Rainmeter 4.0

The following are the changes for the 4.0 beta version of Rainmeter. You can safely install the new 4.0 beta version right over top of your existing Rainmeter 3.3 or earlier installation, and nothing you have done will be lost or changed. There is never any need to uninstall any earlier version of Rainmeter to use the newest version.

Important change to Rainmeter 4.0

Due to future application improvements we intend, which will require the latest version of the Direct2D / DirectWrite graphical engines:

As of Rainmeter 4.0, Windows XP and Windows Vista are no longer supported by the application.

Rainmeter 4.0 requires at least Windows 7 with Service Pack 1 and the Platform Update applied. These should have been automatically applied several years ago by Windows Update, but if you have Windows Update turned off you may need to get and apply these updates manually. Windows versions later than Windows 7 are fully supported.

If you are on Windows XP or Windows Vista, and can't or don't wish to upgrade, you will need to stay on the 3.3 Release version of Rainmeter.

Changes in Rainmeter beta 4.0

Additional details on important changes as the beta cycle progresses can always be found at Change Announcements.

December 19, 2016 - Revision 2731

Added New Skin dialog. This new dialog is opened with the Create new skin button in Manage, or by using the context menus on existing folders. This will allow you to add new root-level folders and skin files, or add folders or files to existing skins. See New Skin for details.

December 4, 2016 - Revision 2722

Changed InputText plugin: InputNumber option has been changed to support negative and fractional numbers. A single - may be the first character, and a single . character may be entered anywhere in the input.

November 27, 2016 - Revision 2720

Added InputText plugin: Added InputLimit (default 0) option to limit the number of characters input.
Added InputText plugin: Added InputNumber (default 0) option to force numeric-only input.
Added Manage: Add a Create new skin button to the top of the skins list. This will create a new root-level config / skin using a skin template you can edit. The new skin will be selected in Manage and opened in your text editor.
Fixed Shape meter: Corrected an issue where using TransformationMatrix on a Shape meter would cause incorrect mouse detection.

November 20, 2016 - Revision 2708

Added Shape meter: Added new Path shape to the Shape Meter.See the documentation at: Shape Meter.
Changed Shape meter: All measurements in "pixels" in the definition of shapes are now Device Independent Pixels, and may be fractional (i.e 10.25 or 0.75) for precision.
Changed Shape meter: Anchor points in the Scale and Skew transform modifiers now default to the center of the shape, rather than the top-left.

November 13, 2016 - Revision 2690

Added Shape meter: Added new Ellipse, Line, Arc and Curve shapes to the Shape meter. See the documentation at: Shape Meter.
Fixed String meter: Fixed a problem parsing the * (skip) parameter in the CharacterSpacing feature of InlineSetting.
Fixed Rainmeter: Corrected an issue parsing options that use the pipe | character as a separator, if they also contained a formula that used the || Logical OR operator.

November 6, 2016 - Revision 2679

Added Shape meter: Draws shapes using Vector graphics. Rectangle and Combine shapes, as well as all Attribute and Transform modifiers implemented in this first beta. See the documentation at: Shape Meter, and other details and examples at Change Announcements.
Changed String meter: Changed the number of degrees of angle in InlineSetting Gradients to allow fractional numbers. (e.g. 45.5).
Fixed About dialog: Corrected an issue where tabs were not being correctly displayed in the Log and Skins panels.
Fixed RunCommand plugin: Corrected a rare issue when the command is run by OnCloseAction, where Rainmeter would unexpectedly terminate and the command not execute.
Changed Language: Updated the Polish language.

September 12, 2016 - Revision 2627

Fixed Lua scripting: Corrected an issue in r2620 that could cause Lua to crash Rainmeter in rare cases.

September 4, 2016 - Revision 2620

Fixed Illustro skins: Changed the remote site used to get the user's WAN IP address in the Network.ini skin.
Changed Lua scripting: Corrected an issue where anything defined in the Initialize() function of a Lua script was treated as "global" across all skins using Lua, which could cause "bleeding" of defined variables between skins, or between script measures in a single skin. Each Lua measure will now run in an entirely separate local context.
Changed Lua scripting: The above change to the context of each Lua measure in a skin has allowed for the use of the Lua dofile function in your scripts. Some changes were made to the standard Lua dofile functionality to support Unicode characters in a file path, and to improve error logging.

July 13, 2016 - Revision 2618

Fixed String meter: Corrected an issue where the position of an inline Gradient could be incorrect when an inline Shadow was also used on the meter.

July 12, 2016 - Revision 2617

Added String meter: Added Shadow InlineSetting type to String meter Inline options. This will allow you to add a drop shadow to all or part of a string.

June 1, 2016 - Revision 2613

Fixed String meter: Corrected an issue where ClipString=1 was not working correctly if W (width) was defined without defining H (height).
Added WebParser: Added UserAgent option to allow setting a custom User Agent String on a WebParser parent measure.
Added WebParser: Added Header1, Header2, Header3... option to allow setting custom HTTP Header Fields on a WebParser parent measure.

Note: If you are not sure what User Agent String or HTTP Header Fields are or whether or not you need them, then you don't...

March 22, 2016 - Revision 2607

Fixed Corrected a rare issue where skins might be loaded with only partial opacity when Windows is first started.
Changed The Rainmeter notification area icon is forced to be visible any time there are no skins loaded in Rainmeter. This will temporarily override any setting for "Show notification area icon" in Manage. This change is to eliminate the possibility that a user could turn off the tray icon and then unload all skins, thus no longer having any way to interact with Rainmeter.
Changed Language: Updates to Russian language.

March 18, 2016 - Revision 2601

Fixed Corrected an issue with the Insider Preview builds of Windows 10 that would not display the Rainmeter Notification Area / System Tray icon.
Fixed String case: Corrected an issue with non-English characters in the string case functionality of both StringCase and InlineSetting=Case in String meters.

March 17, 2016 - Revision 2599

Added String meter: Added Case InlineSetting type to String meter Inline options. This will allow you to set the string case to one of Lower, Upper, Proper, or Sentence for all or part of the displayed text.

March 12, 2016 - Revision 2593

Added SysInfo: Added DOMAINWORKGROUP SysInfoType value to the SysInfo plugin. This will return either the "domain" or "workgroup" set for the system.
Added WebParser: Added LogSubstringErrors parent measure option. If set to "0", this will suppress logging of "Not enough substring" errors. This can be useful when for instance you are using lookahead assertions in a regular expression, and missing (captures) should not be treated as an "error".

March 6, 2016 - Revision 2589

Added Bangs: Added AutoSelectScreen and AutoSelectScreenGroup bangs.

February 17, 2016 - Revision 2587

Removed VirtualDesktops: The VirtualDesktops plugin has been removed from the distribution of Rainmeter. Details can be found at Change Announcements.
Added SysInfo: added a new ADAPTER_TYPE SysInfoType option for the SysInfo plugin. This will return the adapter type (Ethernet or Wireless) as both string and number values. Details can be found at Change Announcements.
Changed InlineSetting: Changed the default value for InlinePattern(N) to .* (the entire string) when the option is left off or set to "". This will allow you to set an InlineSetting on the entire string value without needing to define any matching InlinePattern. Details can be found at Change Announcements.
Fixed GradientColor: Corrected a bug that would not properly adjust a GradientColor InlineSetting when the width or height of the meter was changed but the string value was not.