https://github.com/mistic100/rainmeter-topprocesses
A Rainmeter plugin to show n-number of top processes by either memory or CPU consumption.
https://github.com/mistic100/rainmeter-topprocesses
plugin rainmeter
Last synced: 6 months ago
JSON representation
A Rainmeter plugin to show n-number of top processes by either memory or CPU consumption.
- Host: GitHub
- URL: https://github.com/mistic100/rainmeter-topprocesses
- Owner: mistic100
- Created: 2015-09-16T21:30:37.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-06-06T17:04:22.000Z (over 6 years ago)
- Last Synced: 2025-03-27T14:47:50.588Z (6 months ago)
- Topics: plugin, rainmeter
- Language: C#
- Homepage:
- Size: 97.7 KB
- Stars: 11
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
TopProcesses.dll
================
A Rainmeter plugin to show n-number of top processes by either memory or CPU consumption.
The plugin was created by Chad Voelker and made compatible with Rainmeter 3.2 by Grant Pannell.
The only source I found were for version 2.0.0, not compatible with Rainmeter 3.2.
I decompiled the 2.2.0 DLL in order to have a working base for future improvements.
# Usage
The example bellow display the top four processes by CPU usage.
```
12,8%: Photoshop
9,2%: firefox
3,4%: MsMpEng
0,9%: Spotify
```
```ini
[MeasureTopCPU]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
; Indicates if this init entry should re-look at the process list
; If you have more than one config entry, only ONE needs to do the ReQuery
; 1 = Yes, 0 = No
ReQuery=1
; Merge values of processes with the same name
; e.g. values of "firefox#1" and "firefox#2" are merged with "firefox"
Dedupe=1
; Run in asynchronous mode, see bellow
Async=0
; Pipe-delimited processess to exclude from the list (can handle wildcards, use * character)
; GlobalIgnoredProcesses is MORE efficient than SpecificIgnoredProcesses as it filters globally
; If you use GlobalIgnoredProcesses to filter, processes will be excluded from all measures using the TopProcesses plugin
; GlobalIgnoredProcesses will only be applied to the measure with ReQuery=1
GlobalIgnoredProcesses=rundll32|wscript|userinit|Rainmeter|svchost*
; Pipe-delimited processess to exclude from the list (can handle wildcards, use * character)
; SpecificIgnoredProcesses is LESS efficient than GlobalIgnoredProcesses as it filters per measure.
; The processes below will ONLY be filtered for this measure
; SpecificIgnoredProcesses can be used on any measure, regardless of ReQuery value
SpecificIgnoredProcesses=
; Metric for which to determine top processes (CPU or Memory)
MetricType=CPU
; The top processes to find can be a single number (e.g. 0 = top one process) or a range (0-4 = top five processes)
ProcNums=0-3
; Format in which to return the results... any string including the following keys: %pName %pID %CPU %Memory
; You can also get a substring of a key; e.g. to trim the name to 8 chars use this format: s(%pName,0,7)
Format="%CPU%: %pName"
[TopCPUText]
Meter=String
MeterStyle=Style
MeasureName=MeasureTopCPU
```
## Asynchronous mode
Querying the Windows management database is a expansive process and can cause micro-freezes in all your skins (Rainmeter is single-threaded).
TopProcesses can query the database in a separated thread and provide the result afterward with the `Async=1` option.
**When using this mode you should use child-measures to a lower update rate in order to have the most up-to-date info available.**
This example runs the main measure in asynchronous mode every 5 seconds, and gets the result every 1 second with a child-measure.
```ini
[Rainmeter]
Update=1000
[MeasureTopMain]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
ReQuery=1
Async=1
UpdateDivider=5
[MeasureTopChild]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
UpdateDivider=1
ProcNums=0-3
Format="%CPU%: %pName"
```
## Advanced usage
If you want more control on the data display (eg: number of decimals, decimal symbol) you can use the `%RawCPU` and `%RawMemory` formats. When used with a single process (`ProcNums=0`, `ProcNums=1`, ...) these will return a numeric value which can be formatted as needed.
The example bellow displays the top two processes by memory usage, with different color on the process names and Rainmeter's autoscale.
```ini
; This measure is not used directly, exist to fetch data
[MeasureTopMain]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
ReQuery=1
GlobalIgnoredProcesses=rundll32|wscript|userinit|dwm|Rainmeter|svchost*|System
UpdateDivider=30
; MEASURES
[MeasureTopMemValue1]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
MetricType=Memory
ProcNums=0
Format="%RawMemory"
[MeasureTopMemValue2]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
MetricType=Memory
ProcNums=1
Format="%RawMemory"
[MeasureTopMemName1]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
MetricType=Memory
ProcNums=0
Format="%pName"
[MeasureTopMemName2]
Measure=Plugin
Plugin=Plugins\TopProcesses.dll
MetricType=Memory
ProcNums=1
Format="%pName"
; METERS
[TopMemValue1]
Meter=String
MeasureName=MeasureTopMemValue1
AutoScale=1
StringAlign=Right
Text="%1B"
X=0
Y=0
H=30
[TopMemValue2]
Meter=String
MeasureName=MeasureTopMemValue2
AutoScale=1
StringAlign=Right
Text="%1B"
X=0r
Y=0R
H=30
[TopMemName1]
Meter=String
MeasureName=MeasureTopMemName1
FontColor=200,100,100
FontSize=14
ClipString=1
X=0r
Y=-30r
W=150
H=30
[TopMemName2]
Meter=String
MeasureName=MeasureTopMemName2
FontColor=200,100,100
FontSize=14
ClipString=1
X=0r
Y=0R
W=150
H=30
```
# License
Unknown