TerminalSystemMonitor.jl

Description

This Julia package displays CPU and RAM usage information on your computer. If necessary, one can show GPU usage.

Installation

Step 1. Install Julia

macOS or Linux

To install Julia on macOS or Linux, run the following command in your terminal:

$ curl -fsSL https://install.julialang.org | sh

Windows

For Windows, you can install Julia using the following command in PowerShell:

PS> winget install julia -s msstore
After installation, you can confirm Julia is installed by running:

$ julia --version

Step 2. Download the source code

Clone the repository and navigate to the directory:

$ git clone https://github.com/AtelierArith/TerminalSystemMonitor.jl.git
$ cd TerminalSystemMonitor.jl

Step 3. Resolve dependencies

To resolve dependencies, ensure you are in the correct directory, then activate the Julia environment and instantiate the project:

$ pwd
path/to/TerminalSystemMonitor.jl
$ ls
Project.toml  README.md     main.jl       src
$ julia -q
julia> using Pkg; Pkg.activate("."); Pkg.instantiate()

Usage

Run the program using the following commands:

$ ls
Project.toml  README.md     main.jl       src
$ julia --project main.jl

You will see an output similar to this:

╭───────────────────────╮╭───────────────────────╮
│      ┌               ┐││      ┌               ┐│
│id:  0┤■■■ 24          ││id:  4┤■ 10.1          │
│id:  1┤ 0              ││id:  5┤ 0              │
│id:  2┤■■ 13.9         ││id:  6┤■ 6             │
│id:  3┤ 0              ││id:  7┤ 0              │
│      └               ┘││      └               ┘│
╰───────────────────────╯╰───────────────────────╯
╭───────────────────────╮╭───────────────────────╮
│      ┌               ┐││      ┌               ┐│
│id:  8┤■ 6             ││id: 12┤ 3              │
│id:  9┤ 0              ││id: 13┤ 0              │
│id: 10┤■ 5             ││id: 14┤ 2              │
│id: 11┤ 0              ││id: 15┤ 0              │
│      └               ┘││      └               ┘│
╰───────────────────────╯╰───────────────────────╯
╭────────────────────────────────────────╮
│     ┌               ┐                  │
│Mem: ┤■■■■■■ 58.859    64.0 GiB         │
│     └               ┘                  │
│      Load average: 1.81 2.4 2.73       │
│      Uptime: 0 days, 10:35:59          │
╰────────────────────────────────────────╯

Alternatively, you can launch the functionality directly from Julia:

$ julia --project
julia> using TerminalSystemMonitor; monitor()

Monitoring GPU Usage

Please load CUDA.jl package in advance:

julia> using CUDA; using TerminalSystemMonitor; monitor()

Why not htop?

You might be familiar with the htop-dev/htop, which provides similar functionality. You can use the htop command in Julia as follows:

julia> using Htop_jll; run(Htop_jll.htop())

However, Htop_jll only supports Unix-based systems. The TerminalSystemMonitor.jl package also supports Windows as long as Term.jl and UnicodePlots.jl are available on the platform.

Why not btm?

You can also use ClementTsang/bottom, also known as the btm command:

$ btm -b

We could use bottom_jll instead:

julia> using bottom_jll; run(`$(btm()) --basic`)

Our Julia package TerminalSystemMonitor.jl offers a cross-platform solution and adopts responsive design; chaging layout nicely based on your terminal size.

Can I visualize GPU Apple Silicon processors?

Yes!!! See this PR

julia> using MacOSIOReport; using TerminalSystemMonitor; monitor()