{"id":15057151,"url":"https://github.com/atelierarith/terminalsystemmonitor.jl","last_synced_at":"2025-07-11T05:32:53.654Z","repository":{"id":253108616,"uuid":"842025510","full_name":"AtelierArith/TerminalSystemMonitor.jl","owner":"AtelierArith","description":"Graphical system monitor for Julian","archived":false,"fork":false,"pushed_at":"2024-11-21T00:10:33.000Z","size":82,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-21T01:17:46.264Z","etag":null,"topics":["julia","juliac","julialang"],"latest_commit_sha":null,"homepage":"","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AtelierArith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"terasakisatoshi"}},"created_at":"2024-08-13T14:17:20.000Z","updated_at":"2024-11-21T00:10:37.000Z","dependencies_parsed_at":"2024-11-01T13:23:08.409Z","dependency_job_id":"66904dc8-0b55-4033-9b74-b7054267dcb0","html_url":"https://github.com/AtelierArith/TerminalSystemMonitor.jl","commit_stats":null,"previous_names":["atelierarith/terminalsystemmonitor.jl"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierArith%2FTerminalSystemMonitor.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierArith%2FTerminalSystemMonitor.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierArith%2FTerminalSystemMonitor.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierArith%2FTerminalSystemMonitor.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AtelierArith","download_url":"https://codeload.github.com/AtelierArith/TerminalSystemMonitor.jl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225696755,"owners_count":17509798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["julia","juliac","julialang"],"created_at":"2024-09-24T22:02:56.079Z","updated_at":"2025-07-11T05:32:53.648Z","avatar_url":"https://github.com/AtelierArith.png","language":"Julia","funding_links":["https://github.com/sponsors/terasakisatoshi"],"categories":[],"sub_categories":[],"readme":"# [TerminalSystemMonitor.jl](https://github.com/AtelierArith/TerminalSystemMonitor.jl)\n\n[![Build Status](https://github.com/AtelierArith/TerminalSystemMonitor.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/AtelierArith/TerminalSystemMonitor.jl/actions/workflows/CI.yml?query=branch%3Amain) [![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://AtelierArith.github.io/TerminalSystemMonitor.jl/stable/) [![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://AtelierArith.github.io/TerminalSystemMonitor.jl/dev/)\n\n## Description\n\nThis Julia package displays CPU and RAM usage information on your computer. If necessary, one can show GPU usage.\n\n\u003cimg width=\"2592\" alt=\"image\" src=\"https://github.com/user-attachments/assets/695d64ab-62ba-417e-ac04-e168237b4957\"\u003e\n\n## Installation\n\n### Step 1. Install Julia\n\n#### macOS or Linux\n\nTo install Julia on macOS or Linux, run the following command in your terminal:\n\n```sh\n$ curl -fsSL https://install.julialang.org | sh\n```\n\n#### Windows\n\nFor Windows, you can install Julia using the following command in PowerShell:\n\n```powershell\nPS\u003e winget install julia -s msstore\nAfter installation, you can confirm Julia is installed by running:\n```\n\n```sh\n$ julia --version\n```\n\n### Step 2. Download the source code\n\nClone the repository and navigate to the directory:\n\n```sh\n$ git clone https://github.com/AtelierArith/TerminalSystemMonitor.jl.git\n$ cd TerminalSystemMonitor.jl\n```\n\n### Step 3. Resolve dependencies\nTo resolve dependencies, ensure you are in the correct directory, then activate the Julia environment and instantiate the project:\n\n```sh\n$ pwd\npath/to/TerminalSystemMonitor.jl\n$ ls\nProject.toml  README.md     main.jl       src\n$ julia -q\njulia\u003e using Pkg; Pkg.activate(\".\"); Pkg.instantiate()\n```\n\n## Usage\n\nRun the program using the following commands:\n\n```sh\n$ ls\nProject.toml  README.md     main.jl       src\n$ julia --project main.jl\n```\n\nYou will see an output similar to this:\n\n```bash\n╭───────────────────────╮╭───────────────────────╮\n│      ┌               ┐││      ┌               ┐│\n│id:  0┤■■■ 24          ││id:  4┤■ 10.1          │\n│id:  1┤ 0              ││id:  5┤ 0              │\n│id:  2┤■■ 13.9         ││id:  6┤■ 6             │\n│id:  3┤ 0              ││id:  7┤ 0              │\n│      └               ┘││      └               ┘│\n╰───────────────────────╯╰───────────────────────╯\n╭───────────────────────╮╭───────────────────────╮\n│      ┌               ┐││      ┌               ┐│\n│id:  8┤■ 6             ││id: 12┤ 3              │\n│id:  9┤ 0              ││id: 13┤ 0              │\n│id: 10┤■ 5             ││id: 14┤ 2              │\n│id: 11┤ 0              ││id: 15┤ 0              │\n│      └               ┘││      └               ┘│\n╰───────────────────────╯╰───────────────────────╯\n╭────────────────────────────────────────╮\n│     ┌               ┐                  │\n│Mem: ┤■■■■■■ 58.859    64.0 GiB         │\n│     └               ┘                  │\n│      Load average: 1.81 2.4 2.73       │\n│      Uptime: 0 days, 10:35:59          │\n╰────────────────────────────────────────╯\n```\n\nAlternatively, you can launch the functionality directly from Julia:\n\n```julia\n$ julia --project\njulia\u003e using TerminalSystemMonitor; monitor()\n```\n\n### Monitoring GPU Usage\n\nPlease load `CUDA.jl` package in advance:\n\n```julia\njulia\u003e using CUDA; using TerminalSystemMonitor; monitor()\n```\n\n## Why not `htop`?\n\nYou 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:\n\n```julia\njulia\u003e using Htop_jll; run(Htop_jll.htop())\n```\n\nHowever, `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.\n\n## Why not `btm`?\n\nYou can also use [ClementTsang/bottom](https://github.com/ClementTsang/bottom), also known as the `btm` command:\n\n```sh\n$ btm -b\n```\n\nWe could use `bottom_jll` instead:\n\n```julia\njulia\u003e using bottom_jll; run(`$(btm()) --basic`)\n```\n\nOur 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.\n\n## Can I visualize GPU Apple Silicon processors?\n\nYes!!! See this [PR](https://github.com/AtelierArith/TerminalSystemMonitor.jl/pull/6#issue-2825769951)\n\n```julia\njulia\u003e using MacOSIOReport; using TerminalSystemMonitor; monitor()\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatelierarith%2Fterminalsystemmonitor.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatelierarith%2Fterminalsystemmonitor.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatelierarith%2Fterminalsystemmonitor.jl/lists"}