fCLEANER

# fCLEANER [![Listed on OpenMacApps](https://openmacapps.com/badge.svg)](https://openmacapps.com/apps/fcleaner/) [![Latest release](https://img.shields.io/github/v/release/starbudweiser/fCLEANER)](https://github.com/starbudweiser/fCLEANER/releases/latest) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE) **Cleans the leftovers of a flattened mod setup: metadata, backups, duplicates, sources, readmes…** 🇬🇧 English · 🇫🇷 [Français](#français) ## About fCLEANER scans a folder for assembly leftovers (OS caches, MO2/Vortex/xEdit metadata, backups, duplicates, office documents, graphic sources, readmes and licenses) and purges them on request. By Starbudweiser & Claude Code (Anthropic). MIT License, © 2026 Starbudweiser. Provided as is, without warranty of any kind. See **About fCLEANER** in the app menu. 🍏 **Native Mac app written in Swift, signed and notarized by Apple.** After flattening a mod list (with mO2FLATTENER or by hand), the game folder is full of files the game never uses. fCLEANER scans a folder, shows what would be removed (dry run) and purges it only when you ask. ## Features - **Scan** first (dry run): nothing is deleted, the full list is shown with sizes. - Removes OS caches (thumbs.db, desktop.ini, .DS_Store) and MO2 hidden files (`*.mohidden`). - Removes xEdit modgroups and Vortex / Nexus collection metadata and staging leftovers. - Removes backups and temporary files (`*.bak`, `*.tmp`, `* - copy.*`), office documents and graphic sources (.psd, .xcf, .pdn). - Removes readmes, changelogs and licenses. - Built-in **filtering rules** window listing everything that is targeted. - Interface in **English, French, Italian and Spanish** (follows your Mac's language; can be changed in the app). ### What's new in 1.3.0 - Signed with a Developer ID and notarized by Apple: macOS now opens the app without a security warning. - Rewritten as a native Swift app (no more Python/PyInstaller), same rules, same messages, same look. No more generic PyInstaller launcher, which antivirus scanners tend to flag. - The first letter of the app's name now uses the colour of its logo everywhere it appears. - Version number aligned across the Skyrim Mac Toolkit. ### Screenshots ![Dry-run scan of a mods folder](docs/screenshots/02_scan.png) *Dry-run scan of a mods folder* ## Install **[Download the latest notarized release](https://github.com/starbudweiser/fCLEANER/releases/latest)** · requires **macOS 15 Sequoia** or later on Apple Silicon. ### Requirements A Mac with **Apple Silicon** (M1 or later), **macOS 15 Sequoia** or later. Native Mac app written in Swift and notarized by Apple: no Python, no Wine, no virtual machine needed. ### Installation 1. Download the zip from Nexus Mods (or from the GitHub releases) and unzip it. 2. Move **fCLEANER.app** to your **Applications** folder. ### How to use 1. Click **Choose a folder** and select the assembled game folder (or a mods collection). 2. Click **SCAN** and read the log. 3. If the list is right, click **Purge leftovers**. ### Updates The app checks once a day whether a newer release exists on GitHub and offers to install it (signature checked), remind you later or skip that version; never while an operation is running. The full history is in [CHANGELOG.md](CHANGELOG.md). ## Build Requires Xcode (Swift 6). From the repository folder: ```bash ./build_app.sh ``` ## Languages English, French, Spanish and Italian. The app follows your Mac's preferred language automatically (English if it is none of these four). ## Support 💬 Help and community: [Skyrim Mac Toolkit Discord](https://discord.gg/jRS4rvynx6) · bug reports: [GitHub Issues](https://github.com/starbudweiser/fCLEANER/issues). ### FAQ **Is the purge reversible?** No: deleted files are not moved to the Trash. Always read the scan first, and keep a backup of your modlist. ## License Released under the **MIT License**: free to use, modify and share. Part of the **Skyrim Mac Toolkit**, a set of modding tools built for Skyrim players on Mac. See [LICENSE](LICENSE). --- ## Français **Nettoie les résidus d'une installation de mods aplatie : métadonnées, sauvegardes, doublons, sources, lisez-moi…** 🍏 *Appli Mac native écrite en Swift, signée et notarisée par Apple.* 💬 Aide et communauté : [Discord du Skyrim Mac Toolkit](https://discord.gg/jRS4rvynx6) ### À quoi ça sert Après l'aplatissement d'une liste de mods (avec mO2FLATTENER ou à la main), le dossier du jeu est plein de fichiers que le jeu n'utilise jamais. fCLEANER analyse un dossier, montre ce qui serait supprimé (simulation) et ne purge que sur demande. ### Fonctions - **Analyse** d'abord (simulation) : rien n'est supprimé, la liste complète s'affiche avec les tailles. - Supprime les caches système (thumbs.db, desktop.ini, .DS_Store) et les fichiers masqués de MO2 (`*.mohidden`). - Supprime les modgroups xEdit et les métadonnées et restes de staging des collections Vortex / Nexus. - Supprime les sauvegardes et fichiers temporaires (`*.bak`, `*.tmp`, `* - copie.*`), les documents bureautiques et les sources graphiques (.psd, .xcf, .pdn). - Supprime les lisez-moi, journaux de modifications et licences. - Fenêtre **Règles de filtrage** qui liste tout ce qui est ciblé. - Interface en **français, anglais, italien et espagnol** (suit la langue du Mac ; modifiable dans l'appli). ### Nouveautés de la 1.3.0 - Signée avec un certificat Developer ID et notarisée par Apple : macOS ouvre désormais l'appli sans avertissement de sécurité. - Réécrite en appli Swift native (plus de Python ni de PyInstaller), mêmes règles, mêmes messages, même aspect. Plus de lanceur PyInstaller générique, souvent signalé par les antivirus. - La première lettre du nom de l'appli prend la couleur de son logo partout où il est écrit. - Numéro de version commun à tout le Skyrim Mac Toolkit. ### Mises à jour L'appli vérifie une fois par jour si une version plus récente existe sur GitHub et propose de l'installer (signature vérifiée), de rappeler plus tard ou d'ignorer cette version ; jamais pendant une opération en cours. L'historique complet est dans [CHANGELOG.md](CHANGELOG.md). ### Captures d'écran ![Analyse simulée d'un dossier de mods](docs/screenshots/02_scan.png) *Analyse simulée d'un dossier de mods* ### Configuration requise Un Mac **Apple Silicon** (M1 ou plus récent), **macOS 15 Sequoia** ou plus récent. Appli Mac native écrite en Swift et notarisée par Apple : ni Python, ni Wine, ni machine virtuelle. ### Installation 1. Téléchargez le zip sur Nexus Mods (ou dans les releases GitHub) et décompressez-le. 2. Placez **fCLEANER.app** dans votre dossier **Applications**. ### Utilisation 1. Cliquez sur **Choisir un dossier** et sélectionnez le dossier de jeu assemblé (ou une collection de mods). 2. Cliquez sur **ANALYSER** et lisez le journal. 3. Si la liste convient, cliquez sur **Purger les résidus**. ### Questions fréquentes **La purge est-elle réversible ?** Non : les fichiers supprimés ne vont pas dans la Corbeille. Lisez toujours l'analyse d'abord et gardez une sauvegarde de votre modlist. ### Compiler depuis les sources Nécessite Xcode (Swift 6). Depuis le dossier du dépôt : ```bash ./build_app.sh ``` ### Licence Publié sous **licence MIT** : libre d'utilisation, de modification et de partage. Fait partie du **Skyrim Mac Toolkit**, un ensemble d'outils de modding pensés pour les joueurs de Skyrim sur Mac.