fOMODSIM

# fOMODSIM [![Listed on OpenMacApps](https://openmacapps.com/badge.svg)](https://openmacapps.com/apps/fomodsim/) [![Latest release](https://img.shields.io/github/v/release/starbudweiser/fOMOD_SIM)](https://github.com/starbudweiser/fOMOD_SIM/releases/latest) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE) **FOMOD installer simulator: walk through a mod's installer and preview the result, no mod manager needed.** 🇬🇧 English · 🇫🇷 [Français](#français) ## About fOMODSIM walks through a mod's FOMOD installer and previews the result, no mod manager needed. - **Authors:** Starbudweiser & Claude Code (Anthropic) - **License:** MIT ([LICENSE](LICENSE)). © 2026 Starbudweiser. - Provided as is, without warranty. - FOMOD behavior modeled on Mod Organizer 2, not affiliated with its authors. - In the app: **fOMODSIM › About fOMODSIM** (web version: the **About** link in the header). 🍏 **Native Mac app written in Swift, signed and notarized by Apple.** FOMOD installers normally only run inside Mod Organizer 2 or Vortex, which are hard to use on a Mac. fOMODSIM opens a mod archive, lets you go through its installation steps, evaluates its conditions and flags, and copies the resulting files to a staging folder. Detailed guide: [docs/README.en.md](docs/README.en.md) ## Features - Opens **.zip, .7z, .rar** archives or an unpacked folder (drag and drop supported). - Step-by-step navigation, single and multiple choices, recommended options pre-selected. - Evaluation of FOMOD **conditions and flags**, required files and conditional installs. - Description and image preview for every option. - **Staging** generation: the files resulting from your choices are copied to a folder of your choice. - Optional simulated Skyrim **Data** folder to test file-dependent conditions. - Built-in **CBBE demo mod** to try the app without any archive. - Interface in **English, French, Italian and Spanish** (follows your Mac's language; can be changed in the app). ### What's new in 1.3.1 - The app is now a native macOS (Swift) application, rewritten from the Python version: the same behaviour (checked against the previous engine on about a thousand real mod archives), but no PyInstaller bundle, so antivirus scanners no longer flag it. - Archives (ZIP, 7Z, RAR) are read with the macOS system tool `bsdtar`: nothing to install for `.rar` files, and a few archives the old engine could not read now open. - Your settings (language) carry over; the bundle identifier is unchanged. ### 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. - The app's launcher is now compiled from source when the app is built, instead of using PyInstaller's generic prebuilt launcher, which antivirus scanners tend to flag. No change in features. - New animated splash screen at launch. - 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 ![Welcome screen](docs/screenshots/01_home.png) *Welcome screen* ![Installer step with option preview](docs/screenshots/02_steps.png) *Installer step with option preview* ## Install **[Download the latest notarized release](https://github.com/starbudweiser/fOMOD_SIM/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 **fOMODSIM.app** to your **Applications** folder. ### How to use 1. Drop a mod archive on the window, or click **Load an archive** (or **Load demo mod CBBE** to try). 2. Click an option to see its description and image; use **Continue** / **Back** between steps. 3. Choose the **Staging destination…** (Desktop by default) and, optionally, a **Skyrim Data folder…**. 4. Click **GENERATE STAGING**: the selected files are copied, ready to be added to your game or a modlist. ### Updates The app checks once a day whether a newer release exists on GitHub and offers to open the Nexus page, remind you later or skip that version. Nothing is downloaded or installed automatically. The full history is in [CHANGELOG.md](CHANGELOG.md). ## Build Requires Xcode (Swift 6). From the repository folder: ```bash ./build_app.sh ``` → [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) ## 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/fOMOD_SIM/issues). ### FAQ **A .rar archive won't open.** A few RAR archives use compression filters that macOS cannot read: extract them with another tool and open the folder, or re-pack them as .zip. **The archive has no installer.** The mod has no FOMOD wizard: copy its files directly. ## 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 **Simulateur d'installateurs FOMOD : parcourez l'installateur d'un mod et prévisualisez le résultat, sans gestionnaire de mods.** 🍏 *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 Les installateurs FOMOD ne tournent normalement que dans Mod Organizer 2 ou Vortex, difficiles à utiliser sur Mac. fOMODSIM ouvre une archive de mod, vous fait parcourir ses étapes d'installation, évalue ses conditions et ses flags, et copie les fichiers obtenus dans un dossier de staging. Guide détaillé : [docs/README.fr.md](docs/README.fr.md) ### Fonctions - Ouvre les archives **.zip, .7z, .rar** ou un dossier décompressé (glisser-déposer accepté). - Navigation étape par étape, choix uniques et multiples, options recommandées présélectionnées. - Évaluation des **conditions et flags** FOMOD, des fichiers requis et des installations conditionnelles. - Description et image de chaque option. - Génération d'un **staging** : les fichiers issus de vos choix sont copiés dans le dossier de votre choix. - Dossier **Data** de Skyrim simulé (facultatif) pour tester les conditions qui dépendent des fichiers. - **Mod de démo CBBE** intégré pour essayer l'appli sans archive. - Interface en **français, anglais, italien et espagnol** (suit la langue du Mac ; modifiable dans l'appli). ### Nouveautés de la 1.3.1 - L'appli est désormais une application macOS native (Swift), réécrite à partir de la version Python : même comportement (vérifié contre l'ancien moteur sur environ un millier d'archives de mods réelles), mais plus de paquet PyInstaller, donc plus de signalement par les antivirus. - Les archives (ZIP, 7Z, RAR) sont lues par l'outil système de macOS `bsdtar` : rien à installer pour les `.rar`, et quelques archives que l'ancien moteur ne savait pas lire s'ouvrent maintenant. - Vos réglages (langue) sont conservés ; l'identifiant de l'appli ne change pas. ### 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é. - Le lanceur de l'appli est maintenant compilé depuis les sources à la construction de l'appli, au lieu du lanceur générique précompilé de PyInstaller, souvent signalé par les antivirus. Aucun changement de fonctionnalités. - Nouvel écran de lancement animé. - 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 d'ouvrir la page Nexus, de rappeler plus tard ou d'ignorer cette version. Rien n'est téléchargé ni installé automatiquement. L'historique complet est dans [CHANGELOG.md](CHANGELOG.md). ### Captures d'écran ![Écran d'accueil](docs/screenshots/01_home.png) *Écran d'accueil* ![Étape d'installation avec aperçu de l'option](docs/screenshots/02_steps.png) *Étape d'installation avec aperçu de l'option* ### 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 **fOMODSIM.app** dans votre dossier **Applications**. ### Utilisation 1. Déposez une archive de mod sur la fenêtre, ou cliquez sur **Charger une archive** (ou **Charger le mod démo CBBE** pour essayer). 2. Cliquez sur une option pour voir sa description et son image ; passez d'une étape à l'autre avec **Continuer** / **Retour**. 3. Choisissez la **Destination du Staging…** (Bureau par défaut) et, si besoin, un **Dossier Data de Skyrim…**. 4. Cliquez sur **GÉNÉRER LE STAGING** : les fichiers choisis sont copiés, prêts à être ajoutés au jeu ou à une modlist. ### Questions fréquentes **Une archive .rar ne s'ouvre pas.** Quelques archives RAR utilisent des filtres de compression que macOS ne sait pas lire : décompressez-les avec un autre outil et ouvrez le dossier, ou refaites-en un .zip. **L'archive n'a pas d'installateur.** Le mod n'a pas d'assistant FOMOD : copiez directement ses fichiers. ### Compiler depuis les sources Nécessite Xcode (Swift 6). Depuis le dossier du dépôt : ```bash ./build_app.sh ``` → [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) ### 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.