Note that the background you see is not part of the app, that's just because I use a slightly transparent terminal.
You can install by cloning and using
cargo build --release, or download the pre-compiled binary in Releases. Note this needs the nightly toolchain if you are building.
You can currently install by cloning and building yourself. Note this needs the nightly toolchain if you are building.
Currently, I'm unable to really dev or test on MacOS, so I'm not sure how well this will work, if at all. I'll try to source MacOS hardware to test this application.
Command line options
--helpto show the help screen and exit (basically has all of the below CLI option info).
--avgcpuenables showing the average CPU usage on rustop.
--dot-markeruses a dot marker instead of the default braille marker. This is useful for things like Powershell which display braille markers incorrectly.
--celsiusdisplays the temperature type in Celsius. This is the default.
--fahrenheitdisplays the temperature type in Fahrenheit. This is the default.
--kelvindisplays the temperature type in Kelvin. This is the default.
--versiondisplays the version number and exits.
--rate <RATE>will set the refresh rate in milliseconds. Pick a range from 250ms to
UINT_MAX. Defaults to 1000ms, and higher values may take more resources due to more frequent polling of data, and may be less accurate in some circumstances.
fto freeze updating. Press
fagain to unfreeze. Note updating will still continue in the background.
Right/lto navigate between panels.
Shift+Downscrolls through the list if the panel is a table (Temperature, Disks, Processes).
Escto close a dialog window.
?to get a help screen explaining the controls.
ddto kill the selected process - I would highly recommend you to be careful using this, lest you accidentally kill the wrong process.
cto sort by CPU usage. Sorts in descending order by default. Press again to reverse sorting order.
mto sort by memory usage. Sorts in descending order by default. Press again to reverse sorting order.
pto sort by PID. Sorts in ascending order by default. Press again to reverse sorting order.
nto sort by process name. Sorts in ascending order by default. Press again to reverse sorting order.
- Scrolling currently only scrolls through the list if you are on the Processes panel. This will change in the future.
Regarding Process Use Percentage (on Linux)
I cannot guarantee whether they are 100% accurate. I'm using a technique I found online which seems to be a better indicator of process use percentage at the current time, rather than pulling from, say,
ps (which is average CPU usage over the entire lifespan of the process). I found the options from the library I used to get other data (heim) to be a bit too inaccurate in my testing.
For reference, the formula I am using to calculate CPU process usage is along the lines of:
let idle = idle + iowait; let non_idle = user + nice + system + irq + softirq + steal + guest; let total = idle + non_idle; let prev_total = prev_idle + prev_non_idle; // Both of these values are calculated using the same formula from the previous polling let total_delta : f64 = total - prev_total; let idle_delta : f64 = idle - prev_idle; let final_delta : f64 = total_delta - idle_delta; //... // Get utime and stime from reading /proc/<PID>/stat let after_proc_val = utime + stime; (after_proc_val - before_proc_val) / cpu_usage * 100_f64; //This gives your use percentage. before_proc_val comes from the previous polling
Any suggestions on more accurate data is welcome! Note all other fields should be accurate.
This application was written with the following libraries:
I was looking to try writing more things in Rust, and I love the gotop tool. And thus, this project was born.