https://github.com/atelierarith/terminalsystemmonitor.jl
Graphical system monitor for Julian
https://github.com/atelierarith/terminalsystemmonitor.jl
julia juliac julialang
Last synced: 12 months ago
JSON representation
Graphical system monitor for Julian
- Host: GitHub
- URL: https://github.com/atelierarith/terminalsystemmonitor.jl
- Owner: AtelierArith
- License: mit
- Created: 2024-08-13T14:17:20.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-21T00:10:33.000Z (over 1 year ago)
- Last Synced: 2024-11-21T01:17:46.264Z (over 1 year ago)
- Topics: julia, juliac, julialang
- Language: Julia
- Homepage:
- Size: 80.1 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [TerminalSystemMonitor.jl](https://github.com/AtelierArith/TerminalSystemMonitor.jl)
[](https://github.com/AtelierArith/TerminalSystemMonitor.jl/actions/workflows/CI.yml?query=branch%3Amain) [](https://AtelierArith.github.io/TerminalSystemMonitor.jl/stable/) [](https://AtelierArith.github.io/TerminalSystemMonitor.jl/dev/)
## 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:
```sh
$ curl -fsSL https://install.julialang.org | sh
```
#### Windows
For Windows, you can install Julia using the following command in PowerShell:
```powershell
PS> winget install julia -s msstore
After installation, you can confirm Julia is installed by running:
```
```sh
$ julia --version
```
### Step 2. Download the source code
Clone the repository and navigate to the directory:
```sh
$ 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:
```sh
$ 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:
```sh
$ ls
Project.toml README.md main.jl src
$ julia --project main.jl
```
You will see an output similar to this:
```bash
╭───────────────────────╮╭───────────────────────╮
│ ┌ ┐││ ┌ ┐│
│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
$ julia --project
julia> using TerminalSystemMonitor; monitor()
```
### Monitoring GPU Usage
Please load `CUDA.jl` package in advance:
```julia
julia> using CUDA; using TerminalSystemMonitor; monitor()
```
## Why not `htop`?
You might be familiar with the [htop-dev/htop](https://github.com/htop-dev/htop), which provides similar functionality. You can use the `htop` command in Julia as follows:
```julia
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](https://github.com/ClementTsang/bottom), also known as the `btm` command:
```sh
$ btm -b
```
We could use `bottom_jll` instead:
```julia
julia> using bottom_jll; run(`$(btm()) --basic`)
```
Our Julia package [TerminalSystemMonitor.jl](https://github.com/AtelierArith/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](https://github.com/AtelierArith/TerminalSystemMonitor.jl/pull/6#issue-2825769951)
```julia
julia> using MacOSIOReport; using TerminalSystemMonitor; monitor()
```