Skip to content
pballadaPublic

About

✨ Free, open-source Mac cleaner with a gorgeous native SwiftUI UI: Smart Care, app uninstaller, junk & Xcode cleanup, Space Lens, hidden settings.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Latest commit

 

History

109 Commits

Folders and files

Repository files navigation

ShinyMac icon

ShinyMac

A free, open-source Mac cleaner with a gorgeous native UI.
Clean junk, uninstall apps completely, and keep your Mac fast.

CI macOS 15+ Swift 6.2 MIT License Latest release Downloads GitHub stars Buy me a coffee

Download · brew install --cask pballada/tap/shinymac · Free and open source · no account · no telemetry

Smart Care: essentials ready to run

Features

Everything you need to keep a Mac clean and fast, in one native SwiftUI app with animated aurora backgrounds and Liquid Glass.

Module What it does
✨ Smart Care One scan and one click: removes system junk, empties the Trash and runs speed-up tasks one after the other, then points out updates, leftovers and large files worth a look
🫧 System Junk User caches, logs, Xcode DerivedData and simulators, Homebrew/npm/pip/Yarn/CocoaPods/SwiftPM/Gradle/Cargo caches, Mail downloads, Photos analysis caches, old iPhoto/Aperture libraries, broken preferences, iOS firmware and old device backups, stale downloads
☁️ Cloud Cleanup Finds big and long-unused files downloaded from iCloud Drive, iCloud app documents, Dropbox, Google Drive, OneDrive, Box, pCloud, Proton Drive, Synology Drive and other File Provider apps. Only files untouched for 6 months start checked, and the files stay in the cloud
🗑️ Trash Bins Every Trash, including external drives, with a Finder fallback when access is restricted
✋ Privacy History and cookies for Safari, Chrome, Edge, Brave, Arc, Vivaldi, Opera and Firefox, plus Recent Items. Never touches passwords or bookmarks
🔐 App Permissions Which apps can use the camera, microphone, screen recording, Accessibility, Input Monitoring, Full Disk Access and more, including permissions left by deleted apps
🔧 Maintenance Free up RAM, flush DNS, reindex Spotlight, rebuild Launch Services, reset Quick Look and font caches, thin Time Machine snapshots, speed up Mail, clean up Homebrew, all behind a single password prompt
⏻ Login Items Every launch agent and daemon, which app owns it, whether it's running, and broken items left by deleted apps
🎛️ Hidden Settings macOS options with no switch in System Settings: hidden files, path bar and no .DS_Store on shared drives in Finder; instant Dock auto-hide; screenshot format, shadow and thumbnail; expanded save dialogs and key repeat. One click restores the defaults
📦 Uninstaller Apps plus every file they scatter across 22 Library locations; Reset wipes an app's data but keeps the app. Filters for unused, large and Intel-only apps. Drop an app on the window or Dock icon to start
⬇️ Updater Checks Sparkle feeds and the App Store for newer versions
❓ Leftovers Support files from apps you already deleted, matched conservatively
🧩 Extensions Quick Look and Spotlight plug-ins, preference panes, screen savers, internet plug-ins
📄 Large & Old Files Big and forgotten files by kind, age and size, scanned on all cores
👯 Duplicates Byte-for-byte identical files (SHA-256 verified); keeps the oldest copy
🥧 Space Lens Interactive sunburst map of any folder: hover, drill down, remove
🔥 Shredder Drop files to delete them immediately, skipping the Trash
📈 Menu bar monitor CPU, memory, disk, battery and network at a glance, the top apps by CPU or memory, and one-click RAM cleanup
🛠️ Xcode Simulator runtimes, simulators, DerivedData per project, device support, archives, previews and extra Xcode copies, with safe defaults
🐳 Dev Tools Docker build cache, images and volumes; Colima, OrbStack, Podman and Android emulator disks; npm, pnpm, Yarn, pip, uv, Gradle, Maven, Cargo, Go caches; old Node, Python, Ruby and Rust versions; local AI models; node_modules, virtual envs and build folders in idle projects
🔔 Notifications A gentle note when free space runs low or the Trash gets big, plus weekly Smart Care reminders

Uninstaller Dev Tools Hidden Settings Smart Care scanning

If ShinyMac freed up some space for you, a ⭐ helps other Mac users find it.

Safety first

  • You see everything before it goes. A scan only ever leads to a review list of every file; removal starts from there, and always ends with a confirmation that says how many items go and where.
  • Recoverable by default. Apps, leftovers and large files go to the Trash. Only regenerable data (caches, logs) is deleted outright, and Settings › Move everything to the Trash changes that too.
  • A hard safety net. SafetyGuard refuses to touch system folders, top-level home folders or anything too shallow, no matter what a scanner proposes.
  • Conservative matching. Leftover detection uses bundle-ID component boundaries and exact names, skips Apple, and ignores anything belonging to a vendor whose apps you still have.
  • Opt-in for risky items. Cookies, installer packages, Xcode archives and possible user data start unchecked.

Install

Homebrew

brew tap pballada/tap
brew trust pballada/tap   # newer Homebrew asks you to trust third-party taps once
brew install --cask shinymac

Download

Download the latest ShinyMac-x.y.z.zip from Releases. Releases are a universal binary for Apple silicon and Intel, signed with a Developer ID and notarized by Apple, so they open with a double-click.

ShinyMac updates itself from GitHub releases (ShinyMac › Check for Updates…, or automatically in Settings). Before installing, it verifies that the download is signed with the same Developer ID.

Every commit on main is also built by CI (latest run). Those builds are ad-hoc signed: the first time, right-click the app and choose Open.

Build from source

Requires Xcode 26 or later.

git clone https://github.com/pballada/shinyMac.git
cd shinyMac
make run      # builds build/ShinyMac.app and opens it
make test     # runs the ShinyCore test suite

Releasing

./scripts/release.sh 0.2.0 builds a universal binary, signs it with your Developer ID (hardened runtime), notarizes and staples it, and prints the zip's SHA-256 for the Homebrew cask. One-time setup is described at the top of the script.

Full Disk Access

macOS hides Safari data, Mail downloads, the Trash and some caches from apps. For a complete scan, add ShinyMac under System Settings › Privacy & Security › Full Disk Access; the welcome screen links straight there. Everything else works without it.

Architecture

Sources/
  ShinyCore/   Scanning, sizing and cleaning engine. Foundation only, Swift 6, fully tested.
  ShinyMac/    SwiftUI app (main-actor by default): design system, modules, menu bar monitor.
Tests/
  ShinyCoreTests/   Swift Testing suite, run against fake home folders.
  • Engine and UI are separate. Every scanner is a plain function in ShinyCore, tested against throwaway home folders. The app runs them off the main actor and polls a lock-free ScanProgress.
  • One flow, many modules. CleanupModel drives scan → results → review → clean → done for System Junk, Trash, Privacy and Leftovers.
  • Design system. Per-section themes, a drifting MeshGradient aurora, Liquid Glass (macOS 26) with a material fallback, an orb action button and layered hero illustrations.

Help

Choose Help › ShinyMac Help (⌘?) for a guide to every tool, how ShinyMac keeps your files safe, and answers to common questions.

Support the project

ShinyMac is free, open source and has no ads, tracking or subscriptions. If it saved you some space or time, you can say thanks with a coffee:

Buy me a coffee

Bug reports and ideas are just as welcome in Issues.

License

MIT

About

✨ Free, open-source Mac cleaner with a gorgeous native SwiftUI UI: Smart Care, app uninstaller, junk & Xcode cleanup, Space Lens, hidden settings.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages