# sKYCRASH [](https://openmacapps.com/apps/skycrash/) [](https://github.com/starbudweiser/sKYCRASH/releases/latest) [](LICENSE) **Crash log analyzer for Skyrim Special Edition on Mac (CrossOver).** 🇬🇧 English · 🇫🇷 [Français](#français) ## About sKYCRASH analyzes Skyrim SE/AE crash logs (Crash Logger SSE, SKSE, Papyrus), cross-checks them with your installation and your last save, and ranks the suspects with their evidence. By Starbudweiser & Claude Code (Anthropic). MIT License, © 2026 Starbudweiser. Provided as is, without warranty of any kind. See **About sKYCRASH** in the app menu. 🍏 **Native Mac app written in Swift, signed and notarized by Apple.** sKYCRASH reads your Skyrim crash reports (Crash Logger SSE, .NET Script Framework), SKSE and Papyrus logs, cross-checks them with your actual installation and your last save, and tells you which DLL, plugin, mesh or script is most likely responsible — with the evidence. An optional AI assistant answers your questions about the crash. ## Features - **Analyze logs**: quick scan of all configured log folders (the SKSE folder is always included). - **Deep audit**: rule engine that ranks suspects (DLLs, plugins, scripts) by category — memory, graphics, meshes, animations, saves… - **Verified installation sheet**: SkyrimSE.exe version, matching Address Library, SKSE DLLs, plugins.txt, Creation Club content, 254 full-plugin limit. - **Save comparison**: reads your last `.ess` save and lists plugins added or removed since — a classic cause of crashes on load. - **Crash timeline and history**: DLLs that appeared just before a new kind of crash are flagged as prime suspects. - **AI assistant** (optional): local and private with Ollama, or Google Gemini with your own key. Answers are checked against your real installation and contradicting tips are removed. - **Jev advice check** (optional): with a TypeSafe key, Jev judges each assistant tip against the verified facts of your installation and removes the ones that contradict them. Without a key, the built-in filters still apply. - **New in 1.0.1 — Jev usage**: Settings… > AI shows this month's Jev requests and tokens (input and output), counted by the app, and a **View balance ↗** button that opens the TypeSafe console, where the credit balance is shown. - **New in 1.0.1 — build from GitHub**: `./Build_App.sh` now also works from a plain clone of the repository (ad hoc signing when the toolkit's signing script is missing). - **Self-updating knowledge base**: follows Crash Logger, Community Shaders, Steam updates, r/skyrimmods, SKSE and CrossOver release notes. - **Export diagnostic** (⌘E): one file with the whole crash context, ready to share on a forum or Discord. - **Purge logs**: archives old crash reports so the next crash is easy to spot. - Interface in **English, French, Italian and Spanish** (follows your Mac's language; can be changed in the Language menu). ### Screenshots  *Analyzed logs, log list and AI assistant* ### Privacy Logs stay on your Mac. Network access is used only for the knowledge base updates (public pages from GitHub, Steam, Reddit, SKSE and CodeWeavers, HTTPS only, no account) and, if you enable them, for the Gemini AI assistant and the Jev check (the assistant's tips and the verified facts are sent to TypeSafe). API keys are stored in the macOS Keychain. ### What's new in 1.3.1 - Rebuilt as a **native Swift app** (no more Python or PyInstaller): same analysis, same results (compared line by line with the previous version on the sample logs, on real crash logs and on saves), faster to start, and not flagged by antivirus scanners. Your settings, the knowledge base and the mORTEX export file are picked up as they are. - Automatic updates from inside the app (see Updates below). - New "Language" menu in the menu bar (Automatic, Français, English, Español, Italiano), and drag-and-drop of a log file onto the window. ### 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. ## Install **[Download the latest notarized release](https://github.com/starbudweiser/sKYCRASH/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 **sKYCRASH.app** to your **Applications** folder. ### How to use 1. Install **Crash Logger SSE** (or .NET Script Framework) in your game so that crash reports are written. 2. Open sKYCRASH → **Settings…**: check the game folder (detected automatically under CrossOver) and the log folders. 3. After a crash, click **Analyze logs** for a quick look, then **Deep audit** for the ranked suspects and evidence. 4. Click a log in the list to read it; ask the **AI assistant** a question, or click **Explain the crash**. 5. Fix, test, then **Purge logs** before your next session. ### Updates The app checks once a day whether a newer release exists on GitHub, shows its notes in your language and offers to install it and relaunch (or to remind you later or skip that version). The download is checked (SHA-256, Developer ID signature, notarization) before it replaces the app, and never while an analysis is running. "Check for updates…" in the menu does the same on demand. The full history is in [CHANGELOG.md](CHANGELOG.md). ## Build Requires macOS 15 and the Swift 6 toolchain (Xcode or Command Line Tools). From the repository folder: ```bash ./Build_App.sh ``` The engine (`macos/Sources/CrashCore`) has its own tests: `swift test --package-path macos`. ## Languages English, French, Spanish and Italian. The app follows your Mac's preferred language automatically (English if it is none of these four); it can also be changed in the Language menu. ## Support 💬 Help and community: [Skyrim Mac Toolkit Discord](https://discord.gg/jRS4rvynx6) · bug reports: [GitHub Issues](https://github.com/starbudweiser/sKYCRASH/issues). ### FAQ **No crash log is found.** Crash Logger SSE must be installed and SKSE must start. Check the log folders in Settings… > Log folders. **Do I need an AI?** No. The analysis, audit and evidence work offline without any AI. The assistant is an extra. **Which AI should I choose?** Ollama is 100% local and private (`ollama pull llama3.1`). Gemini gives better answers but sends the report and log excerpts to Google. **What is Jev and do I need it?** Jev (TypeSafe) is an optional second check on the assistant's tips. Paste a TypeSafe key in Settings… > AI to turn it on; the monthly usage is shown right below the key. ## 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 **Analyseur de crash logs pour Skyrim Special Edition sur Mac (CrossOver).** 🍏 *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 sKYCRASH lit vos rapports de crash Skyrim (Crash Logger SSE, .NET Script Framework), vos logs SKSE et Papyrus, les recoupe avec votre installation réelle et votre dernière sauvegarde, et vous indique quelle DLL, quel plugin, mesh ou script est le plus probablement en cause — preuves à l'appui. Un assistant IA facultatif répond à vos questions sur le crash. ### Fonctions - **Analyser les logs** : scan rapide de tous les dossiers de logs configurés (le dossier SKSE est toujours inclus). - **Audit approfondi** : moteur à règles qui classe les suspects (DLL, plugins, scripts) par catégorie — mémoire, graphismes, meshes, animations, sauvegardes… - **Fiche d'installation vérifiée** : version de SkyrimSE.exe, Address Library correspondante, DLL SKSE, plugins.txt, contenu Creation Club, limite de 254 plugins complets. - **Comparaison avec la sauvegarde** : lit votre dernière sauvegarde `.ess` et liste les plugins ajoutés ou retirés depuis — une cause classique de crash au chargement. - **Chronologie et historique des crashs** : une DLL apparue juste avant un nouveau type de crash est signalée comme suspect principal. - **Assistant IA** (facultatif) : local et privé avec Ollama, ou Google Gemini avec votre propre clé. Les réponses sont vérifiées face à votre installation réelle et les conseils contradictoires retirés. - **Vérification des conseils par Jev** (facultatif) : avec une clé TypeSafe, Jev juge chaque conseil de l'assistant face aux faits vérifiés de votre installation et retire ceux qui les contredisent. Sans clé, les filtres intégrés s'appliquent toujours. - **Nouveau en 1.0.1 — consommation Jev** : Réglages… > IA affiche les requêtes et jetons Jev du mois (entrée et sortie), comptés par l'appli, et un bouton **Voir le solde ↗** qui ouvre la console TypeSafe, où s'affiche le solde de crédits. - **Nouveau en 1.0.1 — compilation depuis GitHub** : `./Build_App.sh` fonctionne aussi depuis un simple clone du dépôt (signature ad hoc si le script de signature du kit est absent). - **Base de connaissances auto-alimentée** : suit Crash Logger, Community Shaders, les mises à jour Steam, r/skyrimmods, SKSE et les notes de version de CrossOver. - **Exporter le diagnostic** (⌘E) : un seul fichier avec tout le contexte du crash, prêt à partager sur un forum ou Discord. - **Purger les logs** : archive les anciens rapports pour repérer facilement le prochain crash. - Interface en **français, anglais, italien et espagnol** (suit la langue du Mac ; modifiable dans le menu Langue). ### Nouveautés de la 1.3.1 - Reconstruite en **appli Swift native** (plus de Python ni de PyInstaller) : même analyse, mêmes résultats (comparés ligne à ligne avec la version précédente sur les logs d'exemple, sur de vrais crash logs et sur des sauvegardes), démarrage plus rapide, et plus de fausses alertes antivirus. Vos réglages, la base de connaissances et le fichier d'export pour mORTEX sont repris tels quels. - Mise à jour automatique depuis l'appli (voir Mises à jour ci-dessous). - Nouveau menu « Langue » dans la barre de menus (Automatique, Français, English, Español, Italiano), et glisser-déposer d'un fichier log sur la fenêtre. ### 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, affiche ses notes dans votre langue et propose de l'installer et de se relancer (ou de rappeler plus tard, ou d'ignorer cette version). Le téléchargement est vérifié (SHA-256, signature Developer ID, notarisation) avant de remplacer l'appli, et jamais pendant une analyse. « Rechercher les mises à jour… » dans le menu fait la même chose à la demande. L'historique complet est dans [CHANGELOG.md](CHANGELOG.md). ### Captures d'écran  *Logs analysés, liste des logs et assistant IA* ### 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 **sKYCRASH.app** dans votre dossier **Applications**. ### Utilisation 1. Installez **Crash Logger SSE** (ou .NET Script Framework) dans le jeu pour que les rapports de crash soient écrits. 2. Ouvrez sKYCRASH → **Réglages…** : vérifiez le dossier du jeu (détecté automatiquement sous CrossOver) et les dossiers de logs. 3. Après un crash, cliquez sur **Analyser les logs** pour un aperçu, puis **Audit approfondi** pour les suspects classés et les preuves. 4. Cliquez sur un log de la liste pour le lire ; posez une question à l'**assistant IA**, ou cliquez sur **Expliquer le crash**. 5. Corrigez, testez, puis **Purgez les logs** avant la session suivante. ### Questions fréquentes **Aucun crash log n'est trouvé.** Crash Logger SSE doit être installé et SKSE doit démarrer. Vérifiez les dossiers de logs dans Réglages… > Dossiers de logs. **Faut-il une IA ?** Non. L'analyse, l'audit et les preuves fonctionnent hors ligne sans IA. L'assistant est un plus. **Quelle IA choisir ?** Ollama est 100 % local et privé (`ollama pull llama3.1`). Gemini répond mieux mais envoie le rapport et des extraits de logs à Google. **Qu'est-ce que Jev, et faut-il l'activer ?** Jev (TypeSafe) est une seconde vérification facultative des conseils de l'assistant. Collez une clé TypeSafe dans Réglages… > IA pour l'activer ; la consommation du mois s'affiche juste sous la clé. ### Confidentialité Les logs restent sur votre Mac. Le réseau ne sert qu'à mettre à jour la base de connaissances (pages publiques de GitHub, Steam, Reddit, SKSE et CodeWeavers, HTTPS uniquement, sans compte) et, si vous les activez, à l'assistant IA Gemini et à la vérification Jev (les conseils de l'assistant et les faits vérifiés sont envoyés à TypeSafe). Les clés API sont rangées dans le Trousseau macOS. ### Compiler depuis les sources Nécessite macOS 15 et la chaîne d'outils Swift 6 (Xcode ou Command Line Tools). Depuis le dossier du dépôt : ```bash ./Build_App.sh ``` Le moteur (`macos/Sources/CrashCore`) a ses propres tests : `swift test --package-path macos`. ### 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.