whatisgithub

What is macclean?

iliyami/macclean — explained in plain English

Analysis updated 2026-05-18

64SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A free, open source Mac utility that cleans junk files, scans for malware, uninstalls apps fully, and visualizes disk usage, without subscriptions or tracking.

Mindmap

mindmap
  root((repo))
    What it does
      Cleans junk files
      Scans for malware
      Full app uninstaller
      Disk usage visualizer
    Tech stack
      Swift 6
      SwiftUI
      SQLite
      XPC helper
    Use cases
      Free up disk space
      Remove malware
      Fully uninstall apps
    Audience
      Mac 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

What do people build with it?

USE CASE 1

Free up disk space by finding and removing junk files and duplicates.

USE CASE 2

Scan a Mac for malware and clean browser privacy traces.

USE CASE 3

Fully uninstall an application including its leftover files across the system.

What is it built with?

SwiftSwiftUIAppKitSQLite

How does it compare?

iliyami/maccleannanako0129/tokenbarstevibe/local-screen-agent
Stars646465
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Some scan modules need Full Disk Access granted manually in macOS Privacy settings.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

So what is it?

Mac Clean is a free, open source Mac app that cleans junk files, scans for malware, uninstalls apps completely, and shows you what is taking up space on your hard drive, all from one interface. It is built as a transparent alternative to the paid app CleanMyMac, aiming to match most of its features without a subscription, telemetry, or ads. The app is organized into several areas. The cleanup tools scan for 16 categories of junk such as caches, logs, and leftover files, plus cached mail attachments and items in trash. The protection tools include a malware scanner with three scan depths and a privacy cleaner that removes browsing history and cookies from Safari, Chrome, and Firefox. The performance tools let you manage which apps launch automatically and run maintenance tasks like freeing memory and rebuilding system indexes. The uninstaller looks across many system folders to find every file connected to an app so nothing is left behind. There is also a visual disk map for finding large files, a duplicate file finder, and a secure file shredder. A separate menu bar tool shows live stats for CPU, memory, disk, battery, and network. Under the hood, Mac Clean is written in Swift 6 using SwiftUI and AppKit, with a background helper process for tasks that need elevated permissions and a small SQLite database. The project pays close attention to safety: system folders are protected from deletion, files are sent to Trash rather than erased outright by default, and there is a dry run mode to preview what would be removed before anything happens. You can install it with Homebrew using one command, through a one-line installer script, or by downloading a disk image from the Releases page. It can also be built from source using Swift's build tools, and it includes 275 automated tests. The project is released under the BSD-3-Clause license, a permissive license that allows free use, including commercial use, as long as credit is kept.

Copy-paste prompts

Prompt 1
Walk me through installing Mac Clean with Homebrew and granting Full Disk Access.
Prompt 2
Explain how the 10-level uninstaller finds leftover files for an app.
Prompt 3
Show me how to build Mac Clean from source and run its test suite.
Prompt 4
Compare Mac Clean's safety model to how CleanMyMac handles deletions.

Frequently asked questions

What is macclean?

A free, open source Mac utility that cleans junk files, scans for malware, uninstalls apps fully, and visualizes disk usage, without subscriptions or tracking.

What language is macclean written in?

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

What license does macclean use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is macclean to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is macclean for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.