gitwtfhub

wtf is maccheck?

andyhuo520/maccheck — explained in plain English

Analysis updated 2026-05-18

450SwiftAudience · generalComplexity · 2/5

TL;DR

A macOS app that checks a Mac's hardware, battery, and security status, walks through interactive tests like keyboard and screen checks, and exports a PDF or PNG inspection report.

Mindmap

mindmap
  root((MacCheck))
    What it does
      Local hardware inspection
      Security risk flags
      Exports PDF or PNG report
    Tech stack
      Swift
      SwiftUI
      Xcode build
    Use cases
      Check used Mac before buying
      Store resale inspection
      Personal self check
      Document condition for trade
    Audience
      Buyers and sellers
      Repair shops
      General Mac users
    Notes
      Fully local no upload
      Requires macOS 14 plus
      Not a warranty replacement

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

Inspect a used Mac before buying or selling it to check hardware and security status

REASON 2

Run interactive tests on keyboard, screen, camera, and trackpad before a resale

REASON 3

Check battery health and storage speed on a personal Mac

REASON 4

Export a PDF or PNG report documenting a Mac's condition for a trade

What's in the stack?

SwiftSwiftUIXcode

How it stacks up

andyhuo520/maccheckjustingamer191/holokageroumado/phosphene
Stars450424495
LanguageSwiftSwiftSwift
Setup difficultymoderatehard
Complexity2/54/5
Audiencegeneraldeveloperdeveloper

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

Wtf does this do

MacCheck is a macOS app for inspecting a Mac's hardware, aimed at people buying or selling a used Mac, repair shops checking devices before resale, and anyone who wants to check their own machine's health. Everything runs locally on the Mac itself, and the app does not upload the serial number, test results, or generated reports anywhere. When opened, MacCheck automatically reads basic information such as the model, chip, memory, macOS version, serial number, and model year. It also checks battery cycle count and health, storage space, network status, Bluetooth, and ports. For a second-hand buyer, it flags high-risk items like whether the device is enrolled in Mobile Device Management, whether Activation Lock is on for the Apple ID, and the state of the security chip. Beyond the automatic checks, MacCheck walks the user through hands-on tests that need a person to confirm: lighting up each keyboard key one by one, showing solid colors, grayscale, and checkerboard patterns on the screen, testing audio playback, the microphone, the camera, Touch ID, and the trackpad. It can also measure disk read and write speed, run a performance stress test, and test each physical port individually. There is also a feature that estimates, based on the Mac's memory, how well it could run local AI models. Once testing is done, the results can be saved as a history entry and exported as a PDF or a long PNG image report, which is useful for documenting the condition of a machine during a sale or trade. The interface supports light, dark, and system-matched appearance. MacCheck requires macOS 14 or later and runs on both Apple Silicon and Intel Macs. It can be installed from a downloadable DMG file, or built from source using Xcode 16, with an optional xcodegen step to regenerate the Xcode project. The README notes that MacCheck is meant to assist with inspection and does not replace Apple's own warranty or official service checks, and that some results depend on Apple's servers or the specific hardware available.

Yoink these prompts

Prompt 1
Walk me through how to use MacCheck to inspect a used Mac before I buy it
Prompt 2
Explain what the MDM and Activation Lock warnings in MacCheck mean for a second-hand Mac
Prompt 3
Help me build MacCheck from source using Xcode 16
Prompt 4
What does MacCheck's battery health check tell me about a Mac's condition

Frequently asked questions

wtf is maccheck?

A macOS app that checks a Mac's hardware, battery, and security status, walks through interactive tests like keyboard and screen checks, and exports a PDF or PNG inspection report.

What language is maccheck written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Xcode.

Who is maccheck for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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