@halilertekin/macos-system-cleaner 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Halil Ertekin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,318 @@
+# macOS System Cleaner
+
+A comprehensive collection of scripts to clean RAM, cache and IDEs for improved macOS system performance.
+
+## 🚀 Features
+
+- **RAM Cleaning**: Optimizes system memory and increases performance
+- **Cache Cleaning**: Analyzes and cleans user and system caches
+- **IDE Cleaning**: Manages caches for Xcode, Android Studio, IntelliJ IDEA, PyCharm and other JetBrains IDEs
+- **Brew Integration**: Works integrated with Homebrew updates
+- **User Friendly**: Colorful outputs and clear instructions
+- **Safe Cleaning**: Doesn't touch critical system files
+
+## 📦 Contents
+
+The project includes the following scripts:
+
+### Main Scripts
+
+- **`cache_cleaner.sh`**: Analyzes and cleans user and system caches
+- **`ram_cleaner.sh`**: Performs RAM cleaning and increases system performance
+- **`ide_cleaner.sh`**: Analyzes and cleans caches for Xcode and other IDEs
+- **`main_cleaner.sh`**: Performs all cleaning operations with a single command
+- **`brew_update_with_cache.sh`**: Wrapper that performs automatic cache analysis after Brew updates
+
+### cache_cleaner.sh
+
+Features:
+- Analyzes user caches
+- Lists top 10 largest caches
+- Checks npm, Yarn, Homebrew caches
+- Shows temporary folder sizes
+- Provides safe cleaning options
+
+Commands:
+```
+./scripts/cache_cleaner.sh analyze    # Analyzes caches
+./scripts/cache_cleaner.sh clean     # Cleans caches
+./scripts/cache_cleaner.sh help      # Shows help menu
+```
+
+### ram_cleaner.sh
+
+Features:
+- Shows RAM status (free, active, inactive, wired memory)
+- Cleans disk cache
+- Cleans system cache
+- Cleans background processes
+
+Commands:
+```
+./scripts/ram_cleaner.sh status      # Shows RAM status
+./scripts/ram_cleaner.sh clear       # Performs RAM cleaning
+./scripts/ram_cleaner.sh deep        # Deep RAM cleaning (with background processes)
+```
+
+### ide_cleaner.sh
+
+Features:
+- Detects Xcode, Android Studio, IntelliJ IDEA, PyCharm and other JetBrains IDEs
+- Shows IDE cache folder sizes
+- Safely cleans IDE caches
+- Xcode-specific cleaning operations (DerivedData, Archive, iOS simulator data)
+
+Commands:
+```
+./scripts/ide_cleaner.sh find        # Finds IDE folders and shows sizes
+./scripts/ide_cleaner.sh clean       # Cleans IDE caches
+./scripts/ide_cleaner.sh xcode       # Xcode-specific cleaning operations
+./scripts/ide_cleaner.sh all         # Cleans all IDEs and Xcode
+```
+
+### main_cleaner.sh
+
+Features:
+- Runs all cleaning scripts with a single command
+- User-friendly menu system
+- Individual approval system
+
+Commands:
+```
+./main_cleaner.sh full               # Full system cleaning (RAM + caches + IDE)
+./main_cleaner.sh cache              # Cache cleaning only
+./main_cleaner.sh ram                # RAM cleaning only
+./main_cleaner.sh ide                # IDE cleaning only
+./main_cleaner.sh analyze            # Analysis only (no cleaning)
+```
+
+## 🛠️ Installation
+
+### 1. Clone the Project
+
+```bash
+git clone https://github.com/username/macOS-System-Cleaner.git
+cd macOS-System-Cleaner
+```
+
+### 2. Set Script Permissions
+
+```bash
+chmod +x scripts/*.sh
+chmod +x main_cleaner.sh
+```
+
+### 3. Installation via npm (Global)
+
+```bash
+npm install -g @halilertekin/macos-system-cleaner
+```
+
+After this installation, you can directly use the `msc` command:
+
+```bash
+msc analyze      # Performs system analysis
+msc full         # Performs full system cleaning
+msc cache        # Cache cleaning only
+msc ram          # RAM cleaning only
+msc ide          # IDE cleaning only
+```
+
+### 4. Bash Alias Usage
+
+Also, you can create an alias to use the scripts like terminal commands:
+
+```bash
+# Add to ~/.bashrc or ~/.zshrc file:
+alias msc='/path/to/macOS-System-Cleaner/main_cleaner.sh'
+
+# To apply changes:
+source ~/.bashrc  # or source ~/.zshrc
+```
+
+Then you can directly use these commands:
+
+```bash
+msc analyze      # System analysis
+msc full         # Full cleaning
+msc cache        # Cache cleaning
+msc ram          # RAM cleaning
+msc ide          # IDE cleaning
+```
+
+Or use the convenience aliases that are installed with the install.sh script:
+
+```bash
+msc-analyze      # System analysis
+msc-cache        # Cache cleaning
+msc-ram          # RAM cleaning
+msc-ide          # IDE cleaning
+```
+
+## 📖 Usage
+
+### Cache Cleaning
+
+```bash
+# Analyze caches
+./scripts/cache_cleaner.sh analyze
+
+# Clean caches (confirmation required)
+./scripts/cache_cleaner.sh clean
+
+# Help menu
+./scripts/cache_cleaner.sh help
+```
+
+### RAM Cleaning
+
+```bash
+# Show RAM status
+./scripts/ram_cleaner.sh status
+
+# Perform RAM cleaning
+./scripts/ram_cleaner.sh clear
+
+# Deep RAM cleaning (with background processes)
+./scripts/ram_cleaner.sh deep
+```
+
+### IDE Cleaning
+
+```bash
+# Find IDE folders and show sizes
+./scripts/ide_cleaner.sh find
+
+# Clean IDE caches
+./scripts/ide_cleaner.sh clean
+
+# Xcode-specific cleaning operations
+./scripts/ide_cleaner.sh xcode
+
+# Clean all IDEs and Xcode
+./scripts/ide_cleaner.sh all
+```
+
+### All Cleanings Together
+
+```bash
+# Full system cleaning (RAM + caches + IDE)
+./main_cleaner.sh full
+
+# Analysis only (no cleaning)
+./main_cleaner.sh analyze
+```
+
+After full cleaning operations, you'll see a visual summary screen like:
+
+```
+ ┌─────────────────────────────────────────┐
+ │            CLEANING SUMMARY             │
+ ├─────────────────────────────────────────┤
+ │ • RAM cleaning: ✓                      │
+ │ • Cache cleaning: ✓                    │
+ │ • IDE cleaning: ✓                      │
+ │ • System stability: ✓                  │
+ └─────────────────────────────────────────┘
+```
+
+### Brew Update Integration
+
+```bash
+# Brew update + automatic cache analysis
+./scripts/brew_update_with_cache.sh
+```
+
+## 🧪 Tested IDEs
+
+- **Xcode**: DerivedData, Archive, iOS simulator data
+- **Android Studio**: All versions (4.2, 2020.3, 2021.2, 2022.3, 2023.1)
+- **IntelliJ IDEA**: All versions
+- **PyCharm**: All versions
+- **JetBrains IDEs**: GoLand, WebStorm, CLion, PhpStorm, Rider, AppCode, DataGrip, RubyMine
+- **Visual Studio Code**: Application data
+
+## ⚠️ Warnings
+
+### General Warnings
+- Scripts are designed to increase system performance
+- It's good practice to backup important data before cleaning operations
+- After IDE cleaning, IDEs may need to be restarted
+- Cleaning Xcode DerivedData and Archive folders may affect build times
+
+### RAM Cleaning Warnings
+- During RAM cleaning, running applications may slow down temporarily
+- RAM cleaning is generally only necessary when memory usage is very high
+- RAM cleaning is not recommended if system memory is very low
+
+### IDE Cleaning Warnings
+- Cleaning IDE caches may take longer on first startup
+- Project indexes may need to be recreated
+- Some settings may be reset with cache cleaning
+
+## 🤝 Contributing
+
+If you want to contribute, please submit a pull request. Contributions in the following areas are welcome:
+
+- New IDE supports
+- Performance improvements
+- Bug fixes
+- New features
+- Documentation improvements
+
+### Contributing Steps
+
+1. Fork the project
+2. Create a new branch (`git checkout -b feature/new-feature`)
+3. Make your changes
+4. Commit your changes (`git commit -m 'New feature: Description'`)
+5. Push to your branch (`git push origin feature/new-feature`)
+6. Create a new Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🐛 Issue Reporting
+
+You can report bugs and suggestions in the GitHub Issues section.
+
+## ⚠️ Disclaimer
+
+These scripts are developed purely for system cleaning and performance improvement purposes. The developer is not responsible for any data loss, system instability or other possible issues that may occur while using the scripts. It's recommended to take system backups before using the scripts.
+
+### Sensitive Data Content Disclaimer
+
+This script collection:
+- Does not contain any personal data
+- Does not contain user passwords, API keys or other sensitive information
+- Only performs operations on system cache and temporary files
+- Does not access user data or private files
+
+## 🔧 Homebrew Formula Otomatikleştirme
+
+Bu proje, Homebrew formula dosyasındaki SHA256 hash değerlerini otomatik olarak güncellemek için bir script içerir:
+
+```bash
+# Yeni bir tag için SHA256 hash hesapla ve formula dosyasını güncelle
+./update_formula_sha.sh --update v1.1.0
+
+# GitHub'dan son tag'ı al ve güncelle
+./update_formula_sha.sh --latest
+
+# Sadece hesapla, güncelleme yapma (test modu)
+./update_formula_sha.sh --dry-run v1.1.0
+
+# Mevcut formula versiyonunu göster
+./update_formula_sha.sh --show-current
+
+# Yardım menüsü
+./update_formula_sha.sh --help
+```
+
+Bu script, GitHub'da yeni bir tag oluşturulduğunda, ilgili tarball'ın SHA256 hash'ini hesaplar ve Homebrew formula dosyasını otomatik olarak günceller.
+
+## 🙏 Acknowledgments
+
+- To all open source communities that provide information about macOS system management
+- To all users who provide testing and feedback

package/README.tr.md

@@ -0,0 +1,318 @@
+# macOS System Cleaner
+
+macOS sistem performansını artırmak için RAM, önbellek ve IDE temizliği yapan kapsamlı script koleksiyonu.
+
+## 🚀 Özellikler
+
+- **RAM Temizliği**: Sistem belleğini optimize eder ve performansı artırır
+- **Önbellek Temizliği**: Kullanıcı ve sistem önbelleklerini analiz eder ve gereksiz olanları temizler
+- **IDE Temizliği**: Xcode, Android Studio, IntelliJ IDEA, PyCharm ve diğer JetBrains IDE'lerinin önbelleklerini yönetir
+- **Brew Entegrasyonu**: Homebrew güncellemeleriyle entegre çalışır
+- **Kullanıcı Dostu**: Renkli çıktılar ve açık talimatlar
+- **Güvenli Temizlik**: Kritik sistem dosyalarına dokunmaz
+
+## 📦 İçerik
+
+Proje aşağıdaki script'leri içerir:
+
+### Ana Script'ler
+
+- **`cache_cleaner.sh`**: Kullanıcı ve sistem önbelleklerini analiz eder ve temizler
+- **`ram_cleaner.sh`**: RAM temizliği yapar ve sistem performansını artırır
+- **`ide_cleaner.sh`**: Xcode ve diğer IDE'lerin önbelleklerini analiz eder ve temizler
+- **`main_cleaner.sh`**: Tüm temizlik işlemlerini tek bir komutla yapar
+- **`brew_update_with_cache.sh`**: Brew güncellemesi sonrası otomatik önbellek analizi yapan wrapper
+
+### cache_cleaner.sh
+
+Özellikler:
+- Kullanıcı önbelleklerini analiz eder
+- En büyük 10 önbelleği sıralar
+- npm, Yarn, Homebrew önbelleklerini kontrol eder
+- Geçici klasör boyutlarını gösterir
+- Güvenli temizleme seçenekleri sunar
+
+Komutlar:
+```
+./scripts/cache_cleaner.sh analyze    # Önbellekleri analiz eder
+./scripts/cache_cleaner.sh clean     # Önbellekleri temizler
+./scripts/cache_cleaner.sh help      # Yardım menüsünü gösterir
+```
+
+### ram_cleaner.sh
+
+Özellikler:
+- RAM durumunu gösterir (boş, aktif, pasif, sabitlenmiş bellek)
+- Disk önbelleğini temizler
+- Sistem önbelleğini temizler
+- Arka plan süreçlerini temizler
+
+Komutlar:
+```
+./scripts/ram_cleaner.sh status      # RAM durumunu gösterir
+./scripts/ram_cleaner.sh clear       # RAM temizliği yapar
+./scripts/ram_cleaner.sh deep        # Derin RAM temizliği (arka plan süreçleriyle birlikte)
+```
+
+### ide_cleaner.sh
+
+Özellikler:
+- Xcode, Android Studio, IntelliJ IDEA, PyCharm ve diğer JetBrains IDE'lerini tespit eder
+- IDE önbellek klasörlerinin boyutlarını gösterir
+- IDE önbelleklerini güvenli bir şekilde temizler
+- Xcode'a özel temizlik işlemleri (DerivedData, Archive, iOS simülatör verileri)
+
+Komutlar:
+```
+./scripts/ide_cleaner.sh find        # IDE klasörlerini bulur ve boyutlarını gösterir
+./scripts/ide_cleaner.sh clean       # IDE önbelleklerini temizler
+./scripts/ide_cleaner.sh xcode       # Xcode'a özel temizlik işlemleri
+./scripts/ide_cleaner.sh all         # Tüm IDE'leri ve Xcode temizliklerini yapar
+```
+
+### main_cleaner.sh
+
+Özellikler:
+- Tüm temizlik script'lerini tek bir komutla çalıştırır
+- Kullanıcı dostu menü sistemi
+- Ayrı ayrı onay sistemi
+
+Komutlar:
+```
+./main_cleaner.sh full               # Tüm sistem temizliği (RAM + önbellekler + IDE)
+./main_cleaner.sh cache              # Sadece önbellek temizliği
+./main_cleaner.sh ram                # Sadece RAM temizliği
+./main_cleaner.sh ide                # Sadece IDE temizliği
+./main_cleaner.sh analyze            # Sadece analiz (temizleme yapmaz)
+```
+
+## 🛠️ Kurulum
+
+### 1. Projeyi Klonlama
+
+```bash
+git clone https://github.com/kullaniciadi/macOS-System-Cleaner.git
+cd macOS-System-Cleaner
+```
+
+### 2. Script İzinlerini Ayarlama
+
+```bash
+chmod +x scripts/*.sh
+chmod +x main_cleaner.sh
+```
+
+### 3. npm Üzerinden Kurulum (Global)
+
+```bash
+npm install -g @halilertekin/macos-system-cleaner
+```
+
+Bu kurulum sonrası, doğrudan `msc` komutunu kullanabilirsiniz:
+
+```bash
+msc analyze      # Sistem analizi yapar
+msc full         # Tam sistem temizliği yapar
+msc cache        # Sadece önbellek temizliği
+msc ram          # Sadece RAM temizliği
+msc ide          # Sadece IDE temizliği
+```
+
+### 4. Bash Alias Kullanımı
+
+Ayrıca, script'leri doğrudan terminal komutu gibi kullanmak için bir alias oluşturabilirsiniz:
+
+```bash
+# ~/.bashrc veya ~/.zshrc dosyasına ekleyin:
+alias msc='/path/to/macOS-System-Cleaner/main_cleaner.sh'
+
+# Değişiklikleri uygulamak için:
+source ~/.bashrc  # veya source ~/.zshrc
+```
+
+Sonrasında doğrudan şu komutları kullanabilirsiniz:
+
+```bash
+msc analyze      # Sistem analizi
+msc full         # Tam temizlik
+msc cache        # Önbellek temizliği
+msc ram          # RAM temizliği
+msc ide          # IDE temizliği
+```
+
+Veya install.sh scripti ile kurulan kolaylık alias'larını kullanabilirsiniz:
+
+```bash
+msc-analyze      # Sistem analizi
+msc-cache        # Önbellek temizliği
+msc-ram          # RAM temizliği
+msc-ide          # IDE temizliği
+```
+
+## 📖 Kullanım
+
+### Önbellek Temizliği
+
+```bash
+# Önbellekleri analiz et
+./scripts/cache_cleaner.sh analyze
+
+# Önbellekleri temizle (onay istenir)
+./scripts/cache_cleaner.sh clean
+
+# Yardım menüsü
+./scripts/cache_cleaner.sh help
+```
+
+### RAM Temizliği
+
+```bash
+# RAM durumunu göster
+./scripts/ram_cleaner.sh status
+
+# RAM temizliği yap
+./scripts/ram_cleaner.sh clear
+
+# Derin RAM temizliği (arka plan süreçleriyle birlikte)
+./scripts/ram_cleaner.sh deep
+```
+
+### IDE Temizliği
+
+```bash
+# IDE klasörlerini bul ve boyutlarını göster
+./scripts/ide_cleaner.sh find
+
+# IDE önbelleklerini temizle
+./scripts/ide_cleaner.sh clean
+
+# Xcode'a özel temizlik işlemleri
+./scripts/ide_cleaner.sh xcode
+
+# Tüm IDE'leri ve Xcode temizliklerini yap
+./scripts/ide_cleaner.sh all
+```
+
+### Tüm Temizlikleri Bir Arada
+
+```bash
+# Tüm sistem temizliği (RAM + önbellekler + IDE)
+./main_cleaner.sh full
+
+# Sadece analiz yap (temizleme yapmaz)
+./main_cleaner.sh analyze
+```
+
+Tam temizleme işlemlerinden sonra aşağıdaki gibi görsel bir özet ekranı göreceksiniz:
+
+```
+ ┌─────────────────────────────────────────┐
+ │           TEMİZLEME ÖZETİ              │
+ ├─────────────────────────────────────────┤
+ │ • RAM temizliği: ✓                     │
+ │ • Önbellek temizliği: ✓                │
+ │ • IDE temizliği: ✓                     │
+ │ • Sistem kararlılığı: ✓                │
+ └─────────────────────────────────────────┘
+```
+
+### Brew Update ile Entegrasyon
+
+```bash
+# Brew güncellemesi + otomatik önbellek analizi
+./scripts/brew_update_with_cache.sh
+```
+
+## 🧪 Test Edilmiş IDE'ler
+
+- **Xcode**: DerivedData, Archive, iOS simülatör verileri
+- **Android Studio**: Tüm versiyonlar (4.2, 2020.3, 2021.2, 2022.3, 2023.1)
+- **IntelliJ IDEA**: Tüm versiyonlar
+- **PyCharm**: Tüm versiyonlar
+- **JetBrains IDE'leri**: GoLand, WebStorm, CLion, PhpStorm, Rider, AppCode, DataGrip, RubyMine
+- **Visual Studio Code**: Uygulama verileri
+
+## ⚠️ Dikkat Edilmesi Gerekenler
+
+### Genel Uyarılar
+- Script'ler sistem performansını artırmak için tasarlanmıştır
+- Temizlik işlemleri öncesi önemli verilerinizi yedeklemek iyi bir uygulamadır
+- IDE temizliği sonrası IDE'lerin yeniden başlatılması gerekebilir
+- Xcode DerivedData ve Archive klasörlerinin temizlenmesi derleme sürelerini etkileyebilir
+
+### RAM Temizliği Uyarıları
+- RAM temizliği sırasında çalışan uygulamalar kısa süreli yavaşlayabilir
+- RAM temizliği genellikle sadece yüksek bellek kullanımı durumunda gereklidir
+- Sistem belleği çok düşükse RAM temizliği önerilmez
+
+### IDE Temizliği Uyarıları
+- IDE önbelleklerinin temizlenmesi ilk açılışta daha uzun sürebilir
+- Proje indekslerinin yeniden oluşturulması gerekebilir
+- Bazı ayarlar önbellek temizliğiyle birlikte sıfırlanabilir
+
+## 🤝 Katkıda Bulunma
+
+Katkıda bulunmak isterseniz, lütfen bir pull request gönderin. Aşağıdaki konularda katkılar memnuniyetle karşılanır:
+
+- Yeni IDE destekleri
+- Performans iyileştirmeleri
+- Hata düzeltmeleri
+- Yeni özellikler
+- Belgeleme geliştirmeleri
+
+### Katkıda Bulunma Adımları
+
+1. Projeyi fork edin
+2. Yeni bir branch oluşturun (`git checkout -b feature/yeni-ozellik`)
+3. Değişikliklerinizi yapın
+4. Değişikliklerinizi commit edin (`git commit -m 'Yeni özellik: Açıklama'`)
+5. Branch'inize push edin (`git push origin feature/yeni-ozellik`)
+6. Yeni bir Pull Request oluşturun
+
+## 📄 Lisans
+
+Bu proje MIT Lisansı ile lisanslanmıştır - detaylar için [LICENSE](LICENSE) dosyasına bakın.
+
+## 🐛 Hata Bildirimi
+
+Hataları ve önerileri GitHub Issues bölümünden bildirebilirsiniz.
+
+## ⚠️ Sorumluluk Reddi (Disclaimer)
+
+Bu script'ler tamamen sistem temizliği ve performans artırma amacıyla geliştirilmiştir. Script'leri kullanırken oluşabilecek veri kaybı, sistem kararsızlığı veya diğer olası sorunlardan geliştirici sorumlu değildir. Script'leri kullanmadan önce sistem yedekleri almanız önerilir.
+
+### Hassas Veri İçerik Reddi
+
+Bu script koleksiyonu:
+- Herhangi bir kişisel veri içermemektedir
+- Kullanıcı şifreleri, API anahtarları veya diğer hassas bilgileri içermez
+- Sadece sistem önbelleği ve geçici dosyaları üzerinde işlem yapar
+- Kullanıcı verilerine veya özel dosyalara erişim sağlamaz
+
+## 🔧 Homebrew Formula Otomatikleştirme
+
+Bu proje, Homebrew formula dosyasındaki SHA256 hash değerlerini otomatik olarak güncellemek için bir script içerir:
+
+```bash
+# Yeni bir tag için SHA256 hash hesapla ve formula dosyasını güncelle
+./update_formula_sha.sh --update v1.1.0
+
+# GitHub'dan son tag'ı al ve güncelle
+./update_formula_sha.sh --latest
+
+# Sadece hesapla, güncelleme yapma (test modu)
+./update_formula_sha.sh --dry-run v1.1.0
+
+# Mevcut formula versiyonunu göster
+./update_formula_sha.sh --show-current
+
+# Yardım menüsü
+./update_formula_sha.sh --help
+```
+
+Bu script, GitHub'da yeni bir tag oluşturulduğunda, ilgili tarball'ın SHA256 hash'ini hesaplar ve Homebrew formula dosyasını otomatik olarak günceller.
+
+## 🙏 Teşekkürler
+
+- macOS sistem yönetimi konusunda bilgi sağlayan tüm açık kaynak topluluklarına
+- Test ve geri bildirim sağlayan tüm kullanıcılara