gitwtfhub

wtf is wattcher?

codingstark-dev/wattcher — explained in plain English

Analysis updated 2026-05-18

1SwiftAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A native Mac menu bar app that learns your system's normal activity and flags CPU, memory, or battery-draining processes and newly opened network ports.

Mindmap

mindmap
  root((Wattcher))
    What it does
      Monitor CPU and RAM
      Estimate battery impact
      Track listening ports
    Tech stack
      Swift
      AppKit
      Sparkle
    Use cases
      Spot battery-draining apps
      Find unexpected open ports
      Safely quit misbehaving processes
    Audience
      Mac power users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor which Mac processes are using unusual amounts of CPU or memory.

REASON 2

Detect newly opened listening network ports on your machine.

REASON 3

Safely review and quit a misbehaving process with identity revalidation.

REASON 4

Build a signed, notarized installer for distributing the app yourself.

What's in the stack?

SwiftAppKitSparkle

How it stacks up

codingstark-dev/wattcheraakarsh-goyal/macjuicealtuzar/sonicflow
Stars111
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/51/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Building from source requires macOS 14+ and Xcode 16+, the prebuilt .dmg install is simpler but the app is unsandboxed and not App Store distributed.

The README does not state a license for this project.

Wtf does this do

Wattcher is a native Mac menu bar app that watches which processes are draining your CPU, memory, and battery, and which processes are listening on network ports. It learns what normal activity looks like for your specific machine over time and then flags anomalies that stand out from that baseline, letting you review, ignore, or quietly quit the offending process. The developer is upfront that macOS does not give regular apps access to Activity Monitor's true energy usage numbers, so Wattcher estimates battery impact from CPU and memory behavior rather than measuring actual watts. You install it by downloading a disk image from GitHub Releases and dragging the app into your Applications folder. Once running, it checks your system on a schedule you choose, anywhere from every ten minutes to every eight hours, or you can trigger a check manually. It reads your battery status, looks at every process you own, and matches open network ports back to the process that owns them, then shows all of this in a searchable list with CPU use, memory use, estimated impact, and file location. From there you can open a port in your browser, copy its address, jump to its files in Finder, or safely quit the process, with extra identity checks run right before anything is shut down to make sure the tool is not signaling the wrong process. To avoid false alarms, Wattcher waits for a warm up period before it starts alerting, and requires unusual CPU or memory activity to show up in two checks in a row before flagging it, with fairly high thresholds designed to keep the number of alerts low. It never sends your data anywhere: everything stays on your Mac, with a small rolling history of recent findings kept locally for at most a day. Building it yourself requires macOS 14 or newer and Xcode 16 or newer, using Swift's own test and build tooling along with included shell scripts to produce an installable app bundle or disk image. The project is open source and does not require special system permissions or a privileged background helper, though it does need broad enough access to inspect other processes and network ports, which means it cannot run inside the sandboxed Mac App Store environment.

Yoink these prompts

Prompt 1
Explain how Wattcher decides a process is using too much CPU or memory.
Prompt 2
Help me build and run Wattcher from source on macOS 14.
Prompt 3
Walk me through how Wattcher matches listening ports to their owning process.
Prompt 4
What safety checks does Wattcher run before it terminates a process?

Frequently asked questions

wtf is wattcher?

A native Mac menu bar app that learns your system's normal activity and flags CPU, memory, or battery-draining processes and newly opened network ports.

What language is wattcher written in?

Mainly Swift. The stack also includes Swift, AppKit, Sparkle.

What license does wattcher use?

The README does not state a license for this project.

How hard is wattcher to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is wattcher for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.