https://github.com/sn0walice/detox-mac

A fast, cute and clean Rust-based macOS maintenance CLI tool. Think of it as CleanMyMac, but open-source, modular, and no BS.
https://github.com/sn0walice/detox-mac

clean macos rust

Last synced: 3 months ago
JSON representation

A fast, cute and clean Rust-based macOS maintenance CLI tool. Think of it as CleanMyMac, but open-source, modular, and no BS.

• Host: GitHub
• URL: https://github.com/sn0walice/detox-mac
• Owner: Sn0wAlice
• License: gpl-3.0
• Created: 2025-07-06T19:54:13.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-06T20:18:48.000Z (about 1 year ago)
• Last Synced: 2025-10-04T07:29:25.527Z (9 months ago)
• Topics: clean, macos, rust
• Language: Rust
• Homepage:
• Size: 374 KB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# detox-mac

![](./.github/banner.png)

> A fast, cute and clean Rust-based macOS maintenance TUI tool.

> Think of it as *CleanMyMac*, but open-source, modular, and no BS. 🦀

---

## ✨ Features

### 🧹 Nettoyage

- Nettoyer les caches utilisateur (`~/Library/Caches`)

- Vider la corbeille (`~/.Trash`) ou toutes les corbeilles (volumes montés inclus)

- Nettoyer les logs (`~/Library/Logs`)

- Supprimer les fichiers `.DS_Store` récursivement

- Nettoyer le cache Homebrew (`brew cleanup --prune=all`)

- Nettoyer les données Xcode (DerivedData, DeviceSupport, Simulateurs)

### 💻 Système

- Afficher les infos système (CPU, RAM, disque, version macOS, uptime)

- Vérifier les mises à jour macOS (`softwareupdate -l`)

- Lister les apps les plus volumineuses (`/Applications`)

- Détecter les gros fichiers (> 500 Mo dans `~`)

- Flush DNS (`dscacheutil` + `mDNSResponder`)

- Libérer l'espace disque (snapshots Time Machine)

- Réindexer Spotlight (`mdutil -E`)

- Purger la RAM inactive (`purge`)

### 🚀 Démarrage

- Vue détaillée des LaunchAgents/Daemons (label, statut actif/inactif, tag Apple/Tiers)

- Lister uniquement les agents tiers (non-Apple)

- Désactiver/réactiver les agents tiers sans les supprimer (`launchctl unload/load`)

- Supprimer les LaunchAgents utilisateur (avec `launchctl unload` avant suppression)

- Supprimer tous les LaunchAgents/Daemons

### 🛡️ Sécurité & UX

- **Mode Simulation (dry-run)** : voir ce qui serait fait sans rien modifier

- **Confirmation** avant chaque tâche destructive

- **Dashboard au démarrage** : résumé système + espace récupérable (caches, corbeille, logs) + nombre d'agents

- Affichage de la taille avant/après chaque opération de nettoyage

---

## 🚀 Installation

```bash

git clone https://github.com/youruser/detox-mac.git

cd detox-mac

cargo build --release

cp target/release/detox-mac /usr/local/bin/detox-mac

```

---

## 🔧 Utilisation

Lancez simplement :

```bash

detox-mac

```

L'application s'ouvre en mode TUI interactif avec 4 onglets.

### Raccourcis clavier

| Touche | Action |

|---|---|

| `↑` `↓` / `j` `k` | Naviguer dans les tâches |

| `←` `→` / `Tab` | Changer d'onglet |

| `Entrée` | Exécuter la tâche sélectionnée |

| `Espace` | Cocher/décocher pour exécution groupée |

| `r` | Lancer toutes les tâches cochées |

| `d` | Activer/désactiver le mode simulation |

| `PgUp` / `PgDn` | Scroller le journal |

| `Esc` | Annuler la confirmation / Quitter |

| `q` | Quitter |

### Onglets

| Onglet | Description |

|---|---|

| **Général** | Tâches d'optimisation rapide (caches, corbeille, logs, DNS...) |

| **Nettoyage** | Nettoyage détaillé (Homebrew, Xcode, toutes corbeilles...) |

| **Système** | Infos, mises à jour, scan d'apps/fichiers, DNS, Spotlight, RAM |

| **Démarrage** | Gestion des LaunchAgents/Daemons (vue, filtre, disable/enable) |

---

## 🛡️ Sudo

Certaines opérations nécessitent des privilèges élevés (flush DNS, Spotlight, purge RAM).

Lancez avec sudo si besoin :

```bash

sudo detox-mac

```

Les tâches nécessitant sudo sont marquées `[sudo]` dans l'interface.

---

## 🧪 Mode Simulation

Appuyez sur `d` pour activer le mode simulation. Dans ce mode :

- Aucun fichier n'est supprimé

- Aucune commande système n'est exécutée

- Les tailles et fichiers concernés sont affichés normalement

- Le header et le journal indiquent `[SIMULATION]`

Idéal pour voir ce que l'app ferait avant de lancer pour de vrai.

---

## 🏗️ Architecture

```

src/

├── main.rs              # Point d'entrée, boucle d'événements

├── app.rs               # État de l'app, onglets, tâches, logique

├── ui.rs                # Rendu TUI (ratatui)

└── modules/

    ├── cache.rs          # Nettoyage des caches utilisateur

    ├── trash.rs          # Vidage corbeille (simple + multi-volumes)

    ├── logs.rs           # Nettoyage des logs

    ├── dsstore.rs        # Suppression des .DS_Store

    ├── homebrew.rs       # Nettoyage cache Homebrew

    ├── xcode.rs          # Nettoyage données Xcode

    ├── system.rs         # Commandes système (DNS, Spotlight, RAM...)

    ├── sysinfo.rs        # Infos système & dashboard

    ├── scanner.rs        # Scan apps volumineuses & gros fichiers

    ├── launch.rs         # Suppression LaunchAgents/Daemons

    ├── login.rs          # Vue détaillée, filtre Apple/tiers, disable/enable

    └── utils.rs          # Utilitaires (tailles, dry-run, wrappers)

```

**Dépendances** : `ratatui`, `crossterm` — rien d'autre.

---

## ❤️ Why?

Because we love our Macs, but we don't love bloated cleanup apps.