Lean_Mac

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #machine-learning #deep-learning #linux #macos #windows #awesome #cli #kubernetes #ios #mcp

(★ 12)

Make your MacOS 26 run faster

Lean_Mac Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 macOS Tahoe 26.0 Bloat Service Disabler

[![macOS](https://img.shields.io/badge/macOS-Tahoe%2026.0-blue)](https://www.apple.com/macos/) [![License](https://img.shields.io/badge/License-MIT-green.svg)](https://raw.githubusercontent.com/manooll/Lean_Mac/main/LICENSE) [![Version](https://img.shields.io/badge/Version-2.3-orange)](https://github.com/manooll/Lean_Mac/releases)

> **Your Mac running hot? Battery draining fast? CPU spinning on "nothing"?**

You're not imagining it. macOS Tahoe 26.0 ships with **29+ hidden background processes** chomping through your resources—Apple Intelligence, enhanced Spotlight AI, aggressive cloud sync—even when you never asked for them.

This tool surgically disables the resource hogs while keeping everything you actually use: **AirDrop, Mail, Exchange sync, device location**. Your Mac, but faster, quieter, and more private.

**⚡ Install in seconds:**
```bash
curl -fsSL https://raw.githubusercontent.com/manooll/Lean_Mac/main/install.sh -o install.sh && sudo bash install.sh
```

---

## ⚖️ Legal Disclaimer

**⚠️ Important:** This tool modifies macOS services and may affect system functionality.

- **Not affiliated with Apple Inc.** Independent open-source utility, not authorized or endorsed by Apple
- **Use at your own risk** - Always backup your system before use
- **No warranty** - Authors not responsible for data loss, damage, or malfunction  
- **Educational/personal use only** - Check local laws for redistribution or commercial use
- **Apple trademarks** - All Apple product names used for identification only

---

## ✨ Why You'll Love It

- **⚡ 20-40% less CPU usage** in the background
- **🔋 500MB-1GB RAM freed** for actual work  
- **💾 Dramatically reduced disk I/O** (goodbye constant SSD writes)
- **🔒 Privacy restored** (analytics/telemetry disabled)
- **🛡️ Smart & safe** - Preserves essentials, breaks nothing
- **♻️ Fully reversible** - One command restores everything

---

## 🎯 The Resource Vampires We Kill

### Apple Intelligence (The New CPU Hogs)
```
intelligenceplatformd              # AI platform daemon  
TGOnDeviceInferenceProviderService # On-device AI inference
knowledgeconstructiond             # Knowledge construction
privatecloudcomputed               # Private cloud compute
intelligencetasksd                 # AI task scheduler
```

### Enhanced Spotlight (The Disk Destroyers)  
```
mds_stores                         # Can spike to 60%+ CPU
corespotlightservice               # Core spotlight with AI
spotlightknowledged               # Knowledge-based search
mdworker (multiple)               # Metadata workers gone wild
```

### Cloud Sync Chaos
```
itunescloudd                      # iTunes/Music cloud sync
icloud.searchpartyuseragent       # Find My network spam
icloud.findmydeviced              # Find My device chatter
findmy.findmylocateagent          # Location broadcasting
```

### Analytics & Telemetry (The Spies)
```
analyticsagent                    # Usage analytics collection
feedbackd                         # Feedback harvesting
diagnostics_agent                 # Diagnostic data shipping
wifianalyticsd                    # WiFi usage tracking
```

### Media Processing Madness
```
mediaanalysisd                    # Heavy CPU/RAM for photo analysis
proactiveeventtrackerd           # Predictive behavior tracking
geoanalyticsd                    # Location analytics
memoryanalyticsd                 # Memory usage profiling
```

---

## 📦 What You Get

### 1️⃣ **Bloat Service Disabler** (`disable_bloat_services.sh`)
- Kills 29+ background processes (targeting CPU hogs first)
- Runs automatically: every 60s (system) / 5min (user)
- **Critical fix:** Mail sync services preserved
- **Smart:** Won't interfere with system updates

### 2️⃣ **Cache Cleanup Utility** (`cleanup_caches.sh`)  
- Purges Apple Intelligence caches, Spotlight junk, telemetry logs
- Run manually or schedule independently

### 3️⃣ **Installation System** (`install.sh`)
- Sets up LaunchDaemons/Agents with proper permissions
- Includes clean uninstaller
- Comprehensive logging and error handling

---

## 🔧 Installation & Usage

**Files installed:**
```
/usr/local/bin/disable_bloat_services.sh       # Main bloat killer
/usr/local/bin/cleanup_caches.sh               # Cache cleaner  
/usr/local/bin/uninstall_bloat_disabler.sh     # Easy removal
/Library/LaunchDaemons/com.user.disablebloatservices.plist
~/Library/LaunchAgents/com.user.disablebloatservices.agent.plist
```

**Manual commands:**
```bash
sudo disable_bloat_services.sh    # Run full sweep (includes system services)
sudo cleanup_caches.sh            # Purge system caches
sudo restore_macos_services.sh    # Restore everything
```

**Service management:**
```bash
# Check status
sudo launchctl list | grep disablebloatservices

# Manual start/stop  
sudo launchctl load /Library/LaunchDaemons/com.user.disablebloatservices.plist
sudo launchctl unload /Library/LaunchDaemons/com.user.disablebloatservices.plist
```

---

## 🛡️ What Stays Protected

**Your essentials remain untouched:**
- **Mail Services:** `cloudd`, `icloudmailagent`, `syncdefaultsd`, `protectedcloudkeysyncing`
- **AirDrop/Sharing:** `sharingd`  
- **Exchange Sync:** `exchangesyncd`
- **System Updates:** Protected from interference during updates
- **47+ critical system processes** safe from termination

---

## 📊 Performance Tracking

**Real-time statistics:**
```
Services disabled: 23/29 (79% success)
Processes killed: 15/18 (83% success)
Memory freed: 847MB  
CPU usage reduction: 32%
```

**Monitor the action:**
```bash
# Watch system-wide changes
tail -f /var/log/disable_bloat_services.log

# Monitor user-level changes  
tail -f ~/Library/Logs/disable_bloat_services.log

# Cache cleanup activity
tail -f ~/Library/Logs/cache_cleanup.log
```

---

## 🧠 Smart Features

**System Update Protection**
- Auto-detects active installations/downloads
- Pauses bloat elimination during updates
- Resumes automatically when safe

**Gentle Process Management**  
- SIGTERM first, SIGKILL only if necessary
- 47+ critical processes protected from termination
- Process restart prevention

---

## ⚠️ Before You Install

- **Backup your system** (seriously, do this first)
- **Test on non-critical hardware** if possible
- **Read the code** - you're running this as root
- **macOS Tahoe 26.0 only** (may work on others, YMMV)
- **Restart recommended** after installation for full effect

---

## 🛠️ Troubleshooting

**Services keep coming back?**
```bash
sudo launchctl list | grep -E "(intelligence|spotlight|cloud)"
```

**Still high CPU usage?**
```bash
top -o cpu | head -20  # See what survived the purge
```

**Log permission issues?**
```bash
sudo chown $(whoami):staff ~/Library/Logs/disable_bloat_services.log
```

**Need help?**
1. Check [Issues](https://github.com/manooll/Lean_Mac/issues) page
2. Review log files for error messages
3. Join [Discussions](https://github.com/manooll/Lean_Mac/discussions)

---

## 📈 Version History

### v2.3 - CRITICAL MAIL FIX 🚨
- **Fixed Mail services** (`cloudd`, `icloudmailagent`, `syncdefaultsd` now preserved)
- **System update protection** (won't break during macOS updates)
- **Enhanced process protection** (47+ critical processes safe)
- **Gentler termination** (SIGTERM → SIGKILL progression) 
- **Real-time performance stats** and success tracking

### v2.1 - Performance Beast
- **Shell compatibility fixes** (no more `readarray` issues)
- **Adobe process elimination** (goodbye ACCFinderSync)
- **Figma agent targeting** and improved process identification
- **Success rate tracking** with before/after metrics
- **Deduplication & wildcards** for better efficiency

### v2.0 - The GitHub Release
- **Apple Intelligence support** for Tahoe 26.0
- **Consolidated installation** system
- **Separate cache cleanup** utility
- **Better logging** and error handling

---

## 🤝 Contributing

Found a new bloat service? Performance issue? We want to hear about it.

**Quick start:**
```bash
git clone https://github.com/manooll/Lean_Mac.git
cd Lean_Mac
sudo ./install.sh  # Test on a VM first!
```

**Get involved:**
- [Report Issues](https://github.com/manooll/Lean_Mac/issues)
- [Join Discussions](https://github.com/manooll/Lean_Mac/discussions)
- Submit PRs with improvements

## 🧪 Testing

Run [`shellcheck`](https://www.shellcheck.net/) locally to catch shell script errors before
submitting changes:

```bash
./tests/shellcheck.sh
```

The script expects `shellcheck` to be installed (e.g. via `brew install shellcheck` on
macOS or `apt install shellcheck` on Debian/Ubuntu).

---

## 📄 License & Links

**MIT License** – [View Details](LICENSE)

- **[GitHub Repository](https://github.com/manooll/Lean_Mac)**
- **[Latest Release](https://github.com/manooll/Lean_Mac/releases/latest)**
- **[Report Issues](https://github.com/manooll/Lean_Mac/issues)**

---

## 🙏 Acknowledgments

- macOS optimization community for testing and feedback
- Contributors who made this better
- Apple for creating an OS that keeps us busy 😉

---

**Final warning:** This modifies system services. Could break things. Use at your own risk. Back up first. Authors not responsible for your choices. But hey, it'll probably make your Mac way better. 🚀

Lean_Mac

Lean_Mac Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Lean_Mac

Lean_Mac Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README