An open API service indexing awesome lists of open source software.

https://github.com/larskemper/macos-menu-bar-stats

Simple macOS menu bar app for system monitoring
https://github.com/larskemper/macos-menu-bar-stats

macos rust system-stats tauri

Last synced: 3 months ago
JSON representation

Simple macOS menu bar app for system monitoring

Awesome Lists containing this project

README

          


Logo


mac-menu-bar-stats


Simple macOS menu bar app for system monitoring


Menu Bar Stats Demo


CI
Security Audit

---

## Overview

- [Installation](#installation)
- [Features](#features)
- [Repository structure](#repository-structure)
- [Tech Stack](#tech-stack)
- [Development & Build](#development--build)

## Installation

### Via Homebrew (Recommended)
```bash
brew install --cask larskemper/cask/system-stats
```

### Manual Installation

Download the DMG for your architecture:

- **Apple Silicon**: [system-stats-aarch64.dmg](https://github.com/larskemper/macos-menu-bar-stats/releases/latest)
- **Intel**: [system-stats-x86_64.dmg](https://github.com/larskemper/macos-menu-bar-stats/releases/latest)

### macOS Quarantine Flags

The distributed DMG files are built **without** macOS quarantine flags, so they should install without Gatekeeper warnings.

If you encounter a "cannot be opened because the developer cannot be verified" message, you can manually remove the quarantine flag:

```bash
# Remove quarantine from the app
xattr -dr com.apple.quarantine "/Applications/System Stats.app"

# Verify removal (should return "No such xattr" or no output)
xattr -l "/Applications/System Stats.app"
```

Then try opening the app again.

## Features

- Battery percentage and charging state
- CPU usage across all cores
- Memory usage and utilization percentage

## Repository Structure

- `/src` - Rust source code
- `/icons` - Application icons
- `/capabilities` - Tauri security capabilities
- `/gen` - Generated schema files
- `/target` - Build artifacts

## Tech Stack

- [Tauri 2.0](https://tauri.app/)
- [Rust](https://www.rust-lang.org/)

## Development & Build

### Prerequisites

Ensure you have the following installed:
- Rust (latest stable)
- Xcode Command Line Tools

### Development

Run in development mode:

```bash
cargo run tauri dev
```

### Build

Build the application:

```bash
cargo build
```

Output location:
```
target/release/bundle/macos/
```

### Check & Test

Check for errors:

```bash
cargo check
```

Run linter:

```bash
cargo clippy
```

Format code:

```bash
cargo fmt
```