Skip to content

Latest commit

 

History

History
126 lines (91 loc) · 3.05 KB

README.md

File metadata and controls

126 lines (91 loc) · 3.05 KB

ElModeer

In terminal Process Manager for your system written in Rust

Running ElModeer on Linux

Features

  • Quick glances at System information (CPU & Memoery).
  • A filterable process table that includes different process information.
  • Sorting process table by any column.
  • Adding or removing any column.
  • Change process priority.
  • Managing processes (kill, terminate, suspend, continue).
  • Tree view of processes.
  • Freeze the refreshing or change the rate.
  • Detiled view of each process.

Building

Prerequisites CLI

Building CLI requires rust version >= 1.40 and libclang development packages.

Rust:

Install from your preferred package manager or preferrably use rustup.rs

Clang development packages:

  • Ubuntu/Debian: sudo apt-get install libclang-dev

ElModeer builds under rustc version >= 1.40.0.

cd El-Modeer
cargo build --release

Prerequisites GUI

The GUI components builds on following packages:

  • tauri-apps: ^1.2.3
  • react: ^18.0.15
  • vite: ^4.2.1
  • rust: ^1.40
  • yarn: ^1.22.19
  • npm: ^9.5.0

Npm:

You can install npm using nvm. First isntall nvm curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.31.3/install.sh | bash Then use it to sintall npm for this project, the version is 9.5.0 nvm install <version>

Yarn:

Use npm to install yarn npm install --global yarn

Rust:

You need rust for the GUI as well. Refer to CLI to install Rust.

To build the GUI component

cd El-Modeer/tree/Modeer
yarn tauri build

Running

To run "El-Modeer" CLI, run the following command from the cloned directory

cargo run

To run "El-Modeer" GUI tree, run the following commands from the cloned directory

mkdir ~/el-modeer;
cp ./tree/modeer ~/el-modeer
cargo run -- -t

Command Line

To get "El-Modeer" command in your path, run the following script from the cloned directory

bash install.sh

Then, you can use the CLI simply through:

deer

And you can use the tree GUI through:

deer -t

Usage

Running with no arguments starts ElModeer with the system info and process table and a refresh rate of 2000 ms (2 seconds). These can be changed with command line parameters:

    el-modeer [FLAGS] [OPTIONS]

FLAGS:
    -h, --help               Prints help information
    -V, --version            Prints version information
    -t, --tree               Start GUI tree

OPTIONS:
    -p, --process-height <INT>    Min Percent Height of Process Table. [default: 32]
    -s, --system-info-height <INT>  Min Percent Height of System information. [default: 7]
    -r, --refresh-rate <INT>      Refresh rate in milliseconds. [default: 2000]

Don't want a section? Remove it by setting the height to 0.

For example: deer -p 0 removes the System Information.

In ElModeer 'h' key will show this help:

Running ElModeer on Linux

This process manager extends builds upon the Zenith process manager, so great thanks to them!