mstat 0.1.0

Native macOS menu bar utility for CPU, memory, storage, and system load stats
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# MStat

**MStat** is a native macOS menu bar utility built with Rust that shows live system stats in the top bar.

It supports:
- CPU usage
- Memory usage
- Storage usage
- Swap usage
- Load average

You can customize:
- Which stats are visible
- Warning and critical thresholds
- Theme (including transparent mode)
- Memory/storage display style (`used/total` vs `%`)

## Requirements

- macOS
- Rust toolchain (`cargo`)

## Build

```bash
cargo build --release
```

Binary:

```bash
target/release/mstat
```

## Run

```bash
cargo run --release
```

Or run the built binary directly:

```bash
./target/release/mstat
```

## Install as macOS app (.app)

You can package it as an app bundle:

```bash
mkdir -p "$HOME/Applications/MStat.app/Contents/MacOS"
mkdir -p "$HOME/Applications/MStat.app/Contents/Resources"
cp target/release/mstat "$HOME/Applications/MStat.app/Contents/MacOS/mstat"
chmod +x "$HOME/Applications/MStat.app/Contents/MacOS/mstat"
```

Add `Info.plist` under:

```bash
$HOME/Applications/MStat.app/Contents/Info.plist
```

## Auto-start on login

Create a LaunchAgent:

```bash
$HOME/Library/LaunchAgents/com.pnkjsng.mstat.plist
```

Then load it:

```bash
launchctl bootstrap "gui/$(id -u)" "$HOME/Library/LaunchAgents/com.pnkjsng.mstat.plist"
launchctl enable "gui/$(id -u)/com.pnkjsng.mstat"
```

## Install from crates.io

```bash
cargo install mstat
```

## License

MIT