Skip to content

πŸ¦€βš™οΈ Sudoless performance monitoring for Apple Silicon processors. CPU / GPU / RAM usage, power consumption & temperature 🌑️

License

Notifications You must be signed in to change notification settings

vladkens/macmon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

35 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

macmon – Mac Monitor

Sudoless performance monitoring CLI tool for Apple Silicon processors.

donate

preview

Motivation

Apple Silicon processors don't provide an easy way to see live power consumption. I was interested in this information while testing local LLM models. asitop is a nice and simple TUI to quickly see current metrics, but it reads data from powermetrics and requires root privileges. macmon uses a private macOS API to gather metrics (essentially the same as powermetrics) but runs without sudo. πŸŽ‰

🌟 Features

  • 🚫 Works without sudo
  • ⚑ Real-time CPU / GPU / ANE power usage
  • πŸ“Š CPU utilization per cluster
  • πŸ’Ύ RAM / Swap usage
  • πŸ“ˆ Historical charts + avg / max values
  • 🌑️ Average CPU / GPU temperature
  • 🎨 Switchable colors (6 variants)
  • πŸͺŸ Can be rendered in a small window
  • πŸ¦€ Written in Rust

🍺 Install via Homebrew

brew install vladkens/tap/macmon

πŸ“¦ Install from source

  1. Install Rust toolchain

  2. Clone the repo:

git clone https://github.com/vladkens/macmon.git && cd macmon
  1. Build and run:
cargo run -r
  1. (Optionally) Binary can be moved to bin folder:
sudo cp target/release/macmon /usr/local/bin

πŸš€ Usage

Usage: macmon [OPTIONS] [COMMAND]

Commands:
  raw    Print metrics in JSON format – can be used for piping
  debug  Print debug information
  help   Print this message or the help of the given subcommand(s)

Options:
  -i, --interval <INTERVAL>  Update interval in milliseconds [default: 1000]
  -h, --help                 Print help
  -V, --version              Print version

Controls:
  c - change color
  v - switch charts view: gauge / sparkline
  q - quit

🀝 Contributing

We love contributions! Whether you have ideas, suggestions, or bug reports, feel free to open an issue or submit a pull request. Your input is essential in helping us improve macmon πŸ’ͺ

πŸ“ License

macmon is distributed under the MIT License. For more details, check out the LICENSE.

πŸ” See also


PS: One More Thing... Remember, monitoring your Mac's performance with macmon is like having a personal trainer for your processor β€” keeping those cores in shape! πŸ’ͺ