R A I N M E T E R

Version 0.2 Beta

Info:
 
 
 
 
 
 
Rainmeter is a customizable resource meter that can display your CPU load and the amount of allocated memory. Rainmeter can also display how much data is sent and received through the network interface. The values are displayed with a histogram meter.

The application is a Litestep LoadModule plugin, but it can be used without the Litestep as well. You can use it even with the normal Explorer-shell if you like. Rainmeter is developed and tested on Win2k, but it should work on Win9x also. But Win9x is not officially supported.

And no, Rainmeter does not measure how much it rained last night (at least not yet ;-)

 
Install:
 
 
 
 
 
 
Installing for Litestep

To install just copy the Rainmeter.dll and to your Litestep directory (e.g. C:\Litestep\). You don't need the Rainmeter.exe if you are using Rainmeter as Litestep plugin. Also do not copy the included lsapi.dll over your original file as Litestep might not work after that (or at least it will become unstable). After copying, open your step.rc and add following line:

LoadModule C:\Litestep\Rainmeter.dll

... and recycle. The configuration of Rainmeter is done in a Rainmeter.ini file and not in the step.rc. Make sure that the Rainlendar.ini-file is in the same folder as the DLL.

Installing for some other shell (e.g. Explorer)

Copy all the stuff in the zip-file to some location (e.g. C:\Program files\Rainmeter\). The Rainmeter.ini file must be in the same folder where the Rainmeter.dll is. You also need the lsapi.dll somewhere in the path. 

Important: Currently there is no way to close the Rainmeter if started from the exe-file. You need to kill the Rainmeter process to get rid of the program. 

 

 
Config:
 
 
 
 
 
 
Configuration of the meters are done in a Rainmeter.ini-file. The ini-file is divided in several parts. All the general settings are put under [Rainmeter] section. All the other sections define one meter. The name of the section can be chosen freely as long as it is unique. The ini-file must include [Rainmeter] section.

The different meters and measures can have custom settings. All the settings that are specific to a meter or to a measure are placed in the section where they are used. Check the example that is supplied with the package if you didn't understand the previous sentence (I don't blame you :-).

Here is some info what goes where:

[Rainmeter]

Background
Name of the background image. If this is omitted a copy of the background is taken an used as the background for the meters. Pink color [FF00FF] can be used as transparent color.

WindowX
X-position of the meter window. Negative values can be used too, in which case the position is relative to right edge of the screen.

WindowY
Y-position of the meter window. Negative values can be used too, in which case the position is relative to bottom edge of the screen.

AlwaysOnTop
If set to 1, the window is always on top of other windows. If 0, the window stays back of the other windows.

Draggable
If set to 1, the window can be dragged around with the mouse. If 0, the window stationary.

Update
The update time for the meters. The value should be given in milliseconds. The default value is 1000 (i.e. one second).

HideOnMouseOver
If set to 1 the meter window will disappear if the mouse pointer is moved on it. The window will reappear when the mouse pointer is moved off the position where the window was. If shift, ctrl or alt is hold while moving the mouse, the window will not disappear (or reappear).

Other sections

X
The X-position of the meter inside the meter window.

Y
The Y-position of the meter inside the meter window.

W
The width of the meter.

H
The height of the meter.

Type
Type of the meter. Currently only histograms are supported so the value must be HISTOGRAM.

Measure
This defines what is measured. The valid values are:

  • CPU (measures CPU load)
  • Memory (measures overall memory utilization)
  • PhysicalMemory (measures allocated physical memory)
  • SwapMemory (measures allocated swap)
  • NetIn (measures incoming network traffic)
  • NetOut (measures outgoing network traffic)

Histogram

SecondaryMeasure
This defines the measure for the secondary histogram that is drawn on the same meter. It is not necessary to define this if the other meter is not needed. The allowed values are the same as for the Measure.

PrimaryColor
Color for the primary histogram. The colors are given in RGB format. Separate the color components with ",". E.g. 10,30,255

SecondaryColor
Color for the secondary histogram.

BothColor
Color that is used when the primary and secondary histograms are on top of eachother.

NetIn

NetInSpeed
The maximum speed of your network connection input. The value is given in bits per second.

NetOut

NetOutSpeed
The maximum speed of your network connection output.

 
Bangs:
 
 
 
 
 
 
The Rainmeter can be controlled also with Litestep !Bang-commands.

!RainmeterShow
Displays the Rainmeter-window.

!RainmeterHide
Hides the Rainmeter-window.

 
Legal:
 
 
 
 
 
 
This program is free software. Like Litestep, it is released under GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Please note that this software is still in beta-state and is most likely to have defects and may not work as it should. Use it at your own risk. The author is not responsible for any damage, direct or indirect, that this software may cause.

 

 
Contact:
 
 
 
 
 
 
The latest version will be found from my homepage at:

http://www.iki.fi/~rainy/

You may also send comments and bug-reports to author:

rainy@iki.fi

Please put the name of the product (i.e. Rainmeter) in the subject-field of the mail. It may be useful if you write the version of the product also. If you are reporting a bug, please try to be as exact as possible when describing the symptoms. Also some details of your system (like OS version, Litestep build, and so on) might be helpful.

 

 
Future:
 
 
 
 
 
 
Here is some features which may be included in the future:
  • More things to measure (any suggestions?)
  • Different meters (e.g. bar graph)
  • Text output for the exact values
 
History:
 
 
 
 
 
 

19 JULY 2001 (Version 0.2 ß)

  • Rewrote (almost) everything. 
  • The CPU & memory are now measured a bit different way.

22 FEBRUARY 2001 (Version 0.1 ß)

  • Initial beta release