// General

What is MacPulse?

MacPulse is a native macOS system monitoring app — Activity Monitor reimagined as a gorgeous SwiftUI dashboard. It provides real-time monitoring of seven hardware modules (CPU, Memory, Network, Disk, Thermal & Fans, Battery, GPU), historical trend analytics persisted to SQLite, a menu bar companion, desktop widgets, fan speed control with custom curves, and performance session recording.

What macOS versions are supported?

MacPulse requires macOS 14 Sonoma or later. It also runs on macOS 15 Sequoia. The app is built with SwiftUI and Swift Charts, which require macOS 14 as a minimum.

Does it work on Intel Macs?

Yes. MacPulse ships as a Universal Binary that runs natively on both Apple Silicon and Intel Macs. Some features like P-core/E-core differentiation are Apple Silicon–specific, but all core monitoring works on Intel hardware. Sensors that aren't available on your hardware are gracefully hidden.

How much system resources does MacPulse use?

MacPulse is engineered to be invisible:
  • Less than 1% CPU usage during normal operation
  • Under 50 MB memory footprint
  • Polling automatically reduces when the dashboard window is hidden
  • Database writes are batched (every 60 seconds) to minimize disk I/O
// Installation

Why isn't MacPulse on the Mac App Store?

MacPulse reads hardware sensors (temperatures, fan speeds, GPU stats) through the SMC (System Management Controller) and IOKit, which require running outside the App Store sandbox. The App Store's sandboxing restrictions would prevent access to these low-level system APIs, so MacPulse is distributed directly via LemonSqueezy.

Is MacPulse safe to install?

Absolutely. MacPulse is code-signed and notarized by Apple, meaning macOS has verified it's free of known malware. While it runs without the App Store sandbox (necessary for hardware sensor access), it only reads system telemetry — it never modifies system files, collects personal data, or communicates with external servers beyond license validation.

How do I install MacPulse?

  • Download the .dmg file from the website
  • Open the disk image and drag MacPulse to your Applications folder
  • Launch MacPulse — on first run, macOS may ask you to confirm since it was downloaded from the internet
  • The onboarding screen will guide you through initial setup

How do I uninstall MacPulse?

Quit MacPulse, then drag it from Applications to the Trash. To remove all associated data, also delete ~/Library/Application Support/MacPulse/ (contains the SQLite database, fan curve presets, and license info) and the widget container at ~/Library/Containers/ if you used widgets.
// Features

What's the difference between Trial and Personal license?

The 14-day trial gives you full access to every feature. After the trial expires, you'll need a Personal license ($14, one-time) to continue using MacPulse. The Personal license includes all current features plus future updates. There's no subscription — pay once, use forever.

How do I control fan speeds?

Navigate to the Thermal & Fans module from the sidebar. You'll see each fan with its current RPM and a curve preset selector. Choose from four built-in presets (Silent, Balanced, Performance, Full Speed) or create a custom curve by dragging control points on the temperature-to-RPM chart. When you quit MacPulse, all fans automatically reset to automatic control for safety.

How do I export my data?

MacPulse supports CSV export for both historical data and performance sessions:
  • Historical data: Go to History & Trends, select a module and time range, then click the export button
  • Performance sessions: Select a completed session in the Performance view and click "Export CSV" in the header
Both export options use a standard save dialog so you can choose the destination.

What are Performance Sessions?

Performance Sessions let you record detailed system metrics at 1-second intervals during intensive tasks like gaming, video editing, or compiling. A session captures FPS, frame time, CPU usage, GPU utilization, temperatures, and memory — then provides summary statistics (average FPS, 1% lows, max temperature) and timeline charts. Sessions are saved to the database and can be exported as CSV files.

How do the desktop widgets work?

MacPulse includes WidgetKit widgets in three sizes (small, medium, large) that display system overview data on your desktop. The main app writes averaged data to a shared location every 15 minutes, and widgets refresh every 5 minutes using that data. To add a widget, right-click your desktop, choose "Edit Widgets", and search for MacPulse. Note: MacPulse must be running for widgets to receive updated data.

How long is data retained?

MacPulse uses intelligent downsampling to retain up to 30 days of history while keeping the database compact:
  • Last 24 hours: Full resolution (every minute)
  • 1–7 days ago: 5-minute averages
  • 7–30 days ago: Hourly averages
Older data is automatically cleaned up.
// Troubleshooting

Some sensors show no data or "N/A"

This is normal. Not all sensors are available on every Mac model. For example, battery data is hidden on desktops, P/E-core differentiation only works on Apple Silicon, and some SMC temperature keys vary between models. MacPulse gracefully hides unavailable sensors rather than showing incorrect data.

Fan control doesn't seem to work

Fan control requires SMC write access, which may be restricted on some newer Mac models. Try the following:
  • Ensure no other fan control app (like Macs Fan Control) is running simultaneously
  • Note that macOS may override manual fan speeds if the CPU temperature exceeds safe limits — this is by design for thermal safety
  • MacPulse includes a built-in thermal watchdog that forces fans to maximum if CPU temperature exceeds 95°C

Widgets aren't updating

Widgets require the main MacPulse app to be running. Due to WidgetKit limitations, widgets can only refresh every 5 minutes at most, and data writes from the app are throttled to every 15 minutes to save resources. If widgets appear stale, ensure MacPulse is running and wait a few minutes for the next refresh cycle.

The app uses more CPU than expected

If MacPulse uses more than 1% CPU, check these settings:
  • Increase the polling interval to 10 or 30 seconds in Settings → Polling
  • Disable the FPS overlay if enabled (Settings → Game Mode)
  • Ensure you're not running a Performance Session, which polls at 1-second intervals
  • Close the dashboard window when not in use — MacPulse reduces polling automatically
// License & Billing

How do I activate my license?

After purchasing, you'll receive a license key (UUID format). Go to Settings → About → Activate License Key, paste your key, and click Activate. The license is validated with LemonSqueezy and stored securely in your Mac's Keychain. An offline grace period of 7 days is supported for when you don't have internet access.

Can I use my license on multiple Macs?

The Personal license is tied to a single machine activation. If you need to move it to a new Mac, deactivate the license on the old machine first (Settings → About → Deactivate), then activate on the new one. If you need multiple activations, the Family plan supports additional seats.

What happens when my trial expires?

After the 14-day trial, MacPulse will prompt you to purchase a license. Your historical data is preserved and will be accessible once you activate a license key. No data is deleted when the trial expires.

How do I request a refund?

Refund requests are handled through LemonSqueezy. Contact us via the GitHub support page or the email in your purchase receipt. We aim to respond within 24 hours.

Still have questions?

Open an issue on GitHub and we'll get back to you as soon as possible.

Open a Support Issue