You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -17,56 +17,38 @@ Sudoless performance monitoring CLI tool for Apple Silicon processors.
17
17
18
18
## Motivation
19
19
20
-
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. π
20
+
Apple Silicon processors don't provide an easy way to view live power consumption. I was interested in this data while testing local LLM models. `asitop` is a nice and simple TUI for quickly checking current metrics, but it reads data from `powermetrics` and requires root privileges. `macmon` uses a private macOS API to gather similar metrics (essentially the same as `powermetrics`), but runs without sudo. π
21
21
22
22
## π Features
23
23
24
-
- π« Works without sudo
24
+
- π« Runs without sudo
25
25
- β‘ Real-time CPU / GPU / ANE power usage
26
26
- π CPU utilization per cluster
27
27
- πΎ RAM / Swap usage
28
-
- π Historical charts + avg / max values
28
+
- π Historical charts with average and max values
29
29
- π‘οΈ Average CPU / GPU temperature
30
-
- π¨ Switchable colors (6 variants)
31
-
- πͺ Can be rendered in a small window
30
+
- π¨ Switchable color themes (6 variants)
31
+
- πͺ Can be displayed in a small window
32
32
- π¦ Written in Rust
33
33
34
-
## πΊ Install via Homebrew
34
+
## π₯ Installation
35
35
36
-
You can install[`macmon`](https://formulae.brew.sh/formula/macmon) using [brew](https://brew.sh/):
36
+
- Install[`macmon`](https://formulae.brew.sh/formula/macmon) using [brew](https://brew.sh/):
37
37
38
38
```sh
39
-
$ brew install macmon
39
+
brew install macmon
40
40
```
41
41
42
-
## π₯οΈ Install via MacPorts
43
-
44
-
You can also install [`macmon`](https://ports.macports.org/port/macmon/) using [MacPorts](https://macports.org/):
42
+
- Install [`macmon`](https://ports.macports.org/port/macmon/) using [MacPorts](https://macports.org/):
4. (Optionally) Binary can be moved to bin folder:
67
-
68
-
```sh
69
-
sudo cp target/release/macmon /usr/local/bin
51
+
cargo install macmon
70
52
```
71
53
72
54
## π Usage
@@ -92,15 +74,15 @@ Controls:
92
74
93
75
## π° Piping
94
76
95
-
You can use the pipe subcommand to output metrics in JSON format, which is suitable for piping into other tools or scripts. For example:
77
+
You can use the `pipe` subcommand to output metrics in JSON format, which makes it suitable for piping into other tools or scripts. For example:
96
78
97
79
```sh
98
80
macmon pipe | jq
99
81
```
100
82
101
-
This command runs `macmon` in "pipe" mode and navigate output to `jq` for pretty-printing.
83
+
This command runs `macmon` in "pipe" mode and sends the output to `jq` for pretty-printing.
102
84
103
-
You can also specify the number of samples to run using `-s` or `--samples` parameter (default: `0`, which runs indefinitely), and set update interval in milliseconds using the `-i` or `--interval` parameter (default: `1000` ms). For example:
85
+
You can also specify the number of samples to collect using the `-s` or `--samples` parameter (default: `0`, which runs indefinitely), and set the update interval in milliseconds using the `-i` or `--interval` parameter (default: `1000` ms). For example:
104
86
105
87
```sh
106
88
macmon pipe -s 10 -i 500 | jq
@@ -136,19 +118,38 @@ This will collect 10 samples with an update interval of 500 milliseconds.
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` πͺ
138
+
139
+
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 to helping us improve `macmon`. πͺ
141
140
142
141
## π License
143
-
`macmon` is distributed under the MIT License. For more details, check out the LICENSE.
142
+
143
+
`macmon` is distributed under the MIT License. For more details, check out the LICENSE file.
144
144
145
145
## π See also
146
-
-[tlkh/asitop](https://github.com/tlkh/asitop) β Original tool. Python, requires sudo.
147
-
-[dehydratedpotato/socpowerbud](https://github.com/dehydratedpotato/socpowerbud) β ObjectiveC, sudoless, no TUI.
-[tlkh/asitop](https://github.com/tlkh/asitop) β The original tool. Written in Python, requires sudo.
148
+
-[dehydratedpotato/socpowerbud](https://github.com/dehydratedpotato/socpowerbud) β Written in Objective-C, sudoless, no TUI.
149
+
-[op06072/NeoAsitop](https://github.com/op06072/NeoAsitop) β Written in Swift, sudoless.
150
+
-[graelo/pumas](https://github.com/graelo/pumas) β Written in Rust, requires sudo.
151
+
-[context-labs/mactop](https://github.com/context-labs/mactop) β Written in Go, requires sudo.
151
152
152
153
---
153
154
154
-
*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! πͺ*
155
+
*P.S. One more thing... Monitoring your Mac's performance with `macmon` is like having a personal trainer for your processor β keeping those cores in shape! πͺ*
0 commit comments