Skip to content
Snippets Groups Projects
README.md 3.94 KiB
Newer Older
bstrong5280's avatar
bstrong5280 committed
# System Monitor Plasmoid

bstrong5280's avatar
bstrong5280 committed
Plasmoid to view several Items from system Monitor.
bstrong5280's avatar
bstrong5280 committed
Best way I have found to update to new a version is to use kpackagetool5, details below.

bstrong5280's avatar
bstrong5280 committed
Note: If you are trying to update to newest version using Discover and it is not working, you may be missing the "metadata.desktop" file.
bstrong5280's avatar
bstrong5280 committed
      If so it can be created in the "/home/user-name/.local/share/plasma/plasmoids/com.softtechok.systemmonitorplasmoid" folder
bstrong5280's avatar
bstrong5280 committed
      with to following content, Change the version number to reflect the version you currently have installed.

```
===next line is first line of file====
[Desktop Entry]
Encoding=UTF-8
Name=System Monitor Plasmoid
Comment=Shows System Monitor Information
Icon=org.kde.plasma.systemloadviewer

Type=Service
ServiceTypes=Plasma/Applet

X-Plasma-API=declarativeappletscript
X-Plasma-MainScript=ui/main.qml

X-KDE-PluginInfo-Author=Barry Strong
X-KDE-PluginInfo-Email=bstrong@softtechok.com
X-KDE-PluginInfo-Name=com.softtechok.systemmonitorplasmoid
X-KDE-PluginInfo-License=GPL-3.0+
X-KDE-PluginInfo-Version=2.4
X-KDE-PluginInfo-Website=https://www.opencode.net/bstrong5280
X-KDE-PluginInfo-Category=System Information
X-KDE-ServiceTypes=Plasma/Applet
===previous line is last line of file====
```

## Requirements

bstrong5280's avatar
bstrong5280 committed
Plasma 5 shell (plasma >= 5.7), Starting with Version 2.0 (plasma > 5.20).
bstrong5280's avatar
bstrong5280 committed
Version 1.03 and below, with plasma > 5.20 may need to install ksysguardd.
bstrong5280's avatar
bstrong5280 committed

bstrong5280's avatar
bstrong5280 committed
### Using Discover

Search for "system monitor plasmoid" in Plasma Addons, Plasma Widgets.

### From store.kde.org

bstrong5280's avatar
bstrong5280 committed
1. Go to the desktop.
3. Right Click the desktop, select "Add Widgets".
4. Click "Get New Widgets".
5. Click "Download New Plasma Widgets".
6. Search for "System Monitor Plasmoid".
7. Click Install.
8. Close Installer Window.
9. You can now add the Widget to the desktop, Right Click desktop and select "Add Widgets", search for "System Monitor Plasmoid", drag to desktop.
bstrong5280's avatar
bstrong5280 committed
### Using kpackagetool5

1. Download Package.
2. Open Konsole.
bstrong5280's avatar
bstrong5280 committed
3. Go to download location
bstrong5280's avatar
bstrong5280 committed
4. Enter "kpackagetool5 -i filename". 
bstrong5280's avatar
bstrong5280 committed
5. Close Konsole.
6. You can now add the Widget to the desktop, Right Click desktop and select "Add Widgets", search for "System Monitor Plasmoid", drag to desktop.
bstrong5280's avatar
bstrong5280 committed
7. To update to latest version.
8. Do steps 1 thru 3.
9. Enter "kpackagetool5 -u filename".
10. Close Konsole
11. logout / login to load new version.
bstrong5280's avatar
bstrong5280 committed

# Configuration

Right Click the Plasmoid and select "Configure System Monitor Plasmoid.."
bstrong5280's avatar
bstrong5280 committed
Currently 13 Item types can be selected in the "Layout" tab.
bstrong5280's avatar
bstrong5280 committed
Each Item can be displayed as a bar Graph, a Circular Graph or a Plot Graph.
Colors for each Item can be selected on the "Colors" tab.
bstrong5280's avatar
bstrong5280 committed
Fast plotting or smooth plotting (More Cpu intensive) can be selected for the Plot Graph.
There are options to show borders, to show labels (on top or bottom).
bstrong5280's avatar
bstrong5280 committed
There is an option to show peak values on plotter Items.
bstrong5280's avatar
bstrong5280 committed
What Disks/Partitions to show Space Or activity for can be selected in the "Disk Space" or "Disk IO" tabs.
bstrong5280's avatar
bstrong5280 committed
What network devices to show activity for can be selected in the network tab.
bstrong5280's avatar
bstrong5280 committed
What Gpu Devices to show activity, temperature or frequency for can be selected in the GPU tabs.
bstrong5280's avatar
bstrong5280 committed
What Power Devices to show status for can be selected in the Power tab.
bstrong5280's avatar
bstrong5280 committed
Different layouts can be obtained by selecting the number of columns/rows and layout direction.
bstrong5280's avatar
bstrong5280 committed
**You may need to widen the configuration dialog to see the new options**
bstrong5280's avatar
bstrong5280 committed

bstrong5280's avatar
bstrong5280 committed
**There is now a custom label field for each display item and a display name field**
**(for multiple device items). If you enter a space, no label/name**
**will be displayed. If left blank the default label/name will be displayed.**
bstrong5280's avatar
bstrong5280 committed
**Add the plasmoid to the desktop more than once for additional effects.**
**The plasmoid can also be added multiple times to a panel for a wider widget effect.**
bstrong5280's avatar
bstrong5280 committed
**If more Items are selected than what is allowed by the combination of Columns and Rows, the display will be distorted due some Items overlaying each other. You will either need to select fewer Items or increase the number of columns or rows.**