# Compatibility

Platform and hardware support matrix.

This page details what features and statistics are available on each platform.

## [Operating System Support](/content/docs/compatibility#operating-system-support/index.html)

| Feature                  | Windows | macOS |
|--------------------------|---------|-------|
| System Tray App         | ✅      | ✅    |
| `/api/system`         | ✅      | ✅    |
| `/api/usage`          | ✅      | ✅    |
| `/api/stream` (SSE)   | ✅      | ✅    |
| `/api/ws` (WebSocket)  | ✅      | ✅    |
| `/api/processes`      | ✅      | ✅    |
| `/api/media/status`   | ✅      | ✅    |
| `/api/media/control`   | ✅      | ✅    |
| `/api/pw/shutdown`     | ✅      | ✅    |
| `/api/pw/restart`      | ✅      | ✅    |
| `/api/pw/sleep`        | ✅      | ✅    |
| `/api/pw/hibernate`    | ✅      | ❌    |

### macOS Hibernate

macOS does not expose a separate hibernate command. Sleep on Mac automatically uses "Safe Sleep" which combines RAM and disk storage.

---

## [CPU Statistics](/content/docs/compatibility#cpu-statistics/index.html)

| Stat                  | Windows | macOS |
|-----------------------|---------|-------|
| Manufacturer          | ✅      | ✅    |
| Brand/Model           | ✅      | ✅    |
| Core Count            | ✅      | ✅    |
| Physical Cores        | ✅      | ✅    |
| Base Speed            | ✅      | ✅    |
| Current Load %        | ✅      | ✅    |
| Current Speed         | ✅      | ✅    |
| Temperature           | ❌      | ❌    |

### CPU Temperature

CPU temperature is not currently supported on either platform. Windows requires WMI/OpenHardwareMonitor, and macOS requires SMC access which needs elevated permissions.

---

## [GPU Statistics](/content/docs/compatibility#gpu-statistics/index.html)

### [Windows GPU Support](/content/docs/compatibility#windows-gpu-support/index.html)

| Vendor               | Model | VRAM | Temperature | Utilization |
|----------------------|-------|------|-------------|-------------|
| NVIDIA               | ✅    | ✅   | ✅          | ✅          |
| AMD (rocm-smi)      | ✅    | ❌   | ✅          | ✅          |
| AMD (fallback)       | ✅    | ✅   | ❌          | ❌          |
| Intel                | ✅    | ✅   | ❌          | ❌          |

### NVIDIA Best Support

NVIDIA GPUs have the best support because `nvidia-smi` provides all metrics. AMD falls back to WMIC if `rocm-smi` is not installed. Intel integrated graphics only provide basic info.

### [macOS GPU Support](/content/docs/compatibility#macos-gpu-support/index.html)

| Vendor               | Model | VRAM | Temperature | Utilization |
|----------------------|-------|------|-------------|-------------|
| Apple Silicon        | ✅    | ❌   | ❌          | ❌          |
| Intel (iGPU)        | ✅    | ❌   | ❌          | ❌          |
| AMD (dGPU)          | ✅    | ❌   | ❌          | ❌          |

### macOS GPU detection uses `system_profiler` which only provides model name.

---

## [Memory Statistics](/content/docs/compatibility#memory-statistics/index.html)

| Stat                  | Windows | macOS |
|-----------------------|---------|-------|
| Total RAM             | ✅      | ✅    |
| Used RAM              | ✅      | ✅    |
| Free RAM              | ✅      | ✅    |
| Usage %               | ✅      | ✅    |

---

## [Disk Statistics](/content/docs/compatibility#disk-statistics/index.html)

| Stat                  | Windows | macOS |
|-----------------------|---------|-------|
| Drive Letter/Mount    | ✅      | ✅    |
| Filesystem Type       | ✅      | ✅    |
| Total Size            | ✅      | ✅    |
| Used Space            | ✅      | ✅    |
| Available Space       | ✅      | ✅    |
| Usage %               | ✅      | ✅    |

---

## [Media Control](/content/docs/compatibility#media-control/index.html)

| Feature               | Windows | macOS |
|-----------------------|---------|-------|
| Get Now Playing       | ✅      | ✅    |
| Play/Pause            | ✅      | ✅    |
| Next Track            | ✅      | ✅    |
| Previous Track        | ✅      | ✅    |
| Volume Control        | ✅      | ✅    |
| Mute/Unmute          | ✅      | ✅    |

### System-Wide Control

Media controls work with any application (Spotify, Chrome, VLC, etc.). Volume controls affect the global system output.

---

## [Process Management](/content/docs/compatibility#process-management/index.html)

| Stat/Feature          | Windows | macOS |
|-----------------------|---------|-------|
| Process Name          | ✅      | ✅    |
| Instance Count        | ✅      | ✅    |
| Memory Usage          | ✅      | ✅    |
| CPU utilization        | ✅      | ✅    |
| `GET /processes/{name}`| ✅    | ✅    |
| `POST /processes/kill`| ✅    | ✅    |
| `POST /processes/launch`| ✅    | ✅    |
| `POST /processes/focus`| ✅    | ✅    |

---

## [WebSocket API](/content/docs/compatibility#websocket-api/index.html)

| Feature               | Windows | macOS |
|-----------------------|---------|-------|
| Stats subscription     | ✅      | ✅    |
| Media subscription     | ✅      | ✅    |
| Process subscription   | ✅      | ✅    |
| Media commands         | ✅      | ✅    |
| Process commands       | ✅      | ✅    |
| Operation feedback     | ✅      | ✅    |

### Lazy Loop Spawning

WebSocket monitoring loops only run when clients are subscribed. Zero CPU overhead when idle.