Version 2.1.1 - UI/ UX Improvements

Version 2.1.1 Release Notes

Summary Minor update focused on user experience improvements - adds console type detection feedback and application icon.

What's New

Console Type Detection Feature

• Level 3: Console type now displayed immediately when selecting a PRODINFO file
• Level 3: Console type shown in "Get Keys from SD" success popup
• Level 1/2: Console type detection support for users with customized lockpick (dumps/prodinfo.dec)

UI/UX Improvements

• Updated terminology: "donor PRODINFO" → "PRODINFO" (more accurate for various use cases)
• Added application icon - now displays on taskbar and window title
• Improved user feedback with console type information in key workflows

Version 2.1.0 - Add Offline version

NAND Fix Pro v2.1 - Release Notes

What's New

Offline Mode / File Mode

Version 2.1 introduces a major new feature: Offline Mode (File Mode). You can now toggle between Live Mode and Offline Mode depending on your workflow.

Live Mode (Original)

• Works directly with your Switch's eMMC via USB connection
• Requires Hekate's USB Tools (eMMC RAW GPP mode)

Offline Mode (New)

• Works with RAWNAND.bin backup files
• No need for live eMMC connection
• Perfect for working with existing backups or troubleshooting without the console connected

Add emuMMC detection 2.0.4

What's New in v2.0.4

emuMMC Raw Partition Support Added comprehensive support for detecting and working with emuMMC raw partitions exposed through Hekate's UMS mode.

Key Features:

• Automatic detection of emuMMC raw devices (USBSTOR\DISK&VEN_HEKATE&PROD_SD_GPP)
• Track drive type (eMMC vs emuMMC) throughout the entire repair workflow
• Smart boot file placement based on detected drive type:
• eMMC: backup/[emmcID]/restore/
• emuMMC: backup/[emmcID]/restore/emummc/
• Enhanced user interface feedback showing detected drive type
• All Level 1/2/3 repair processes now support both eMMC and emuMMC targets

How It Works:

When you connect your Switch in Hekate UMS mode, NAND Fix Pro will automatically detect whether you're working with physical eMMC or an emuMMC raw partition. After completing a repair process, the "Copy BOOT to SD" button will automatically place boot0 and boot1 files in the correct directory structure for your setup.

Compatibility:

• Works with all existing Level 1, Level 2, and Level 3 repair workflows
• No configuration needed - detection is fully automatic
• Supports standard Hekate emuMMC raw partition configurations

Downloads

• Download the exe if you want to have an auto-extract archive
• Download the 7z if you want to extract the pack yourself

Enhanced Stability and Console Repair Tools

What's New in v2.0.3

This update introduces a critical feature for users encountering mismatch errors when attempting Level 1 or Level 2 repairs on hybrid (Erista/Mariko) consoles. It also includes general application cleanup and better state management.

---

New Feature: Console Type Override

A new "Override Console Type Detection" option has been added to the Level 1 and Level 2 tabs.

• Solve Mismatch Errors: This is specifically designed for users whose Switch console (e.g., a Mariko V2, Lite, or OLED) reports an incorrect boot chip ID to the software, often leading to a boot chain crash with error messages like "Erista pkg1 on Mariko" or "Wrong pkg1 flashed".
• Manual Selection: When enabled, a new dialog appears, allowing the user to manually select the correct console type (Erista or Mariko) for the EmmcHaccGen process, overriding the automatic detection from the PRODINFO.

---

General Improvements and Fixes

• Improved Application Reset: The Reset App function has been enhanced to be more thorough. It now correctly clears the console type override checkbox state and resets the manual console type selection. It also clears the temporary paths (keys, prodinfo, and firmware) from the application's configuration file (config.ini).

Another Bug Fix for Level 3 process

What's New in v2.0.2

This is a targeted hotfix release focused on improving the stability and error handling of the most critical part of the application: writing the NAND image to the eMMC.

Hotfix: eMMC Write Stability

• Advanced USB Error Detection: Added specific detection for "Bad file descriptor" errors (OSError: errno 9). This error often occurs due to an unstable USB connection, a bad cable, or a port issue during the raw write process.
• New User-Friendly Dialog: If this errno 9 error occurs, a new dialog box will now appear. It explains the potential causes (bad cable, USB 2.0 vs 3.0 port, etc.) and suggests concrete solutions to the user instead of just failing.
• More Robust Write Loop: The os.write() command inside the raw copy function is now wrapped in its own try...except block. This allows the app to immediately catch a write failure as it happens and report it, rather than failing silently or ambiguously.
• Safer File Handle Closing: The os.fsync() and os.close() commands are now in separate try...except blocks. This ensures that even if fsync fails (which is normal on some systems), the app will still attempt to properly close the file handle to the eMMC, preventing it from being left in a locked state.

Bug Fix

What's New in v2.0.1

This release is a maintenance update focused on fixing bugs, improving workflow stability, and enhancing the overall user experience.

Bug Fixes & Quality of Life Improvements

Smarter SD Card & File Handling

• Manual SD Card Selection: If automatic detection of the Hekate SD card fails, you will now be prompted to select the drive manually. This provides a crucial fallback and ensures the application is always usable.
• Context-Aware "Get Keys from SD": The tool is now smarter. It will only look for, validate, and import a donor PRODINFO file if you are on the "Level 3" tab, preventing confusion and unnecessary file operations for Level 1 and 2 users.
• Robust Session Management: Fixed a critical bug where temporary paths for prod.keys, prodinfo, and firmware were saved to config.ini. The app now starts with a clean slate for these paths every time, preventing errors from using stale data from a previous session.

Enhanced Cleanup & Application Reset

• Complete Cleanup After Copy: The "Copy BOOT to SD" function now performs a full cleanup. After successfully copying the files, it automatically deletes the entire temporary working directory, as well as the temporary prod.keys and PRODINFO files, leaving your system clean.
• Supercharged "Reset App" Button: The reset button is now far more powerful. It will:
  • Delete any temporary prod.keys and PRODINFO files.
  • Find and remove all switch_gui_* temporary folders created by the app.
  • Reset all workflow states and clear the log for a truly fresh start.
• Improved Exit Cleanup: The application now properly cleans up temporary files and folders if you close it before completing the "Copy BOOT to SD" step.

Under-the-Hood Optimizations

• Smoother Progress Bar: The visual progress bar has been refactored to update on a single line without flickering. It now uses a more efficient rendering method for a smoother user experience during long operations.
• Persistent Temporary Folders: Fixed a critical issue where the temporary folder containing the final BOOT0 and BOOT1 files could be deleted prematurely if an operation failed or the app was closed. The folder now persists until it is successfully used or manually reset.
• Dependency Check on Launch: The application startup script now verifies that required Python packages (wmi, psutil) are installed, and will attempt to install them automatically if they are missing.

How to Update

1. Download NAND-Fix-Pro-v2.0.1.exe (self-extracting archive) from the assets below.
2. It is recommended to delete your old config.ini file to ensure the new session management works correctly.
3. Double-click the new .exe file to extract all contents.
4. Run NANDFixPro.exe.

2.0.0

What's New in v2.0.0

Self-Extracting Package

• One-Click Installation: Version 2.0.0 is packaged as a self-extracting executable (SFX)
• Simply double-click the downloaded .exe file and it will automatically extract all files to your chosen location
• No manual extraction needed: No need for 7-Zip or WinRAR to unpack the archive

Automatic Dependency Installation

The NANDFixPro.exe launcher now handles all dependencies automatically on first run.

• OSFMount: Automatically installs PassMark OSFMount silently in the background
• Python Runtime: Installs a portable Python environment without affecting your system
• .NET Framework: Ensures required .NET components are installed silently
• Python Packages: Auto-installs required libraries (wmi, psutil) without user intervention
• Zero Configuration: Just run the launcher and everything is set up for you

Built-in PRODINFO Editor

Edit your PRODINFO file directly within the application without external tools.

• Serial Number Modification: Change the 14-character serial number with validation
• WiFi Region Selection: Update region codes (America, Europe, Japan, Asia, Australia)
• Frame Color Customization: Modify bezel and main body colors with a visual color picker
• Real-time Preview: See color changes instantly before applying
• Integrity Verification: Built-in CRC16 and SHA256 validation to ensure file integrity
• Automatic Checksum Recalculation: All checksums are automatically updated when you save changes
• Access via Menu: Available from the new "PRODINFO Editor" menu (enabled after loading a PRODINFO file)

Visual Progress Tracking

No more wondering what's happening during long operations.

• Progress Bars: Visual progress bars for all 7z extractions, file copies, and eMMC writes
• Real-time Updates: See exactly how much data has been processed and estimated time remaining
• Percentage Display: Clear percentage indicators for all major operations
• Cleaner Log Output: Progress bars update on a single line instead of flooding the log

Enhanced Workflow Management

Streamlined process from start to finish with intelligent button states.

• Smart Button States: Buttons change color to indicate status (blue=active, green=completed, gray=disabled)
• "Get Keys from SD" Integration: One-click import of prod.keys and donor PRODINFO from SD card
• Automatic PRODINFO Detection: Finds generated_prodinfo_from_donor.bin, PRODINFO, or PRODINFO.bin automatically
• "Copy BOOT to SD" Button: Automatically detects the correct backup folder and copies files
• Reset Application State: New "Reset App" button to start fresh without restarting the program
• Workflow Persistence: Completed steps stay green so you always know where you are in the process

Improved Hardware Detection

More reliable detection using Windows Management Instrumentation (WMI).

• Precise eMMC Detection: Identifies Switch eMMC by exact hardware ID (VEN_HEKATE&PROD_EMMC_GPP)
• SD Card Recognition: Detects Hekate SD card mounts by hardware signature (VEN_HEKATE&PROD_SD_RAW)
• Automatic Backup Folder Location: Finds backup/[emmcID]/restore folders without manual navigation
• Safer Operation: Multiple drive detection prevents accidental writes to wrong devices

Advanced Options & Settings

More control over the application's behavior.

• Custom Temporary Directory: Choose where to store temporary files (useful for drives with more space)
• Automatic Cleanup: Temp directories are properly cleaned up after operations complete
• Disk Space Validation: Pre-flight check ensures 60GB free space before starting operations
• Dependency Auto-Install: Automatically installs required Python packages (wmi, psutil) on first run

Better Logging & Debugging

Comprehensive logging system for troubleshooting.

• Save Log Function: Export logs to timestamped text files for sharing or analysis
• Clear Log Function: Clean the log view without closing the application
• Detailed Error Messages: More informative error messages with context
• Crash Recovery: Unhandled exceptions are logged to error_log.txt with full stack traces

Quality of Life Improvements

• PRODINFO Menu Integration: Dedicated menu item for PRODINFO editing (disabled until file is loaded)

---

Installation & Windows Defender Notice

Download and Extract

1. Download the NAND-Fix-Pro-v2.0.0.exe file from the latest release page.
2. Important: The downloaded .exe file is actually a 7-Zip self-extracting archive. When you run it or extract it, Windows Defender may flag the NANDFixPro.exe launcher as a potential threat.

False Positive Warning

This is a known false positive detection. The NANDFixPro.exe launcher is flagged because it:

• Automatically elevates to administrator privileges
• Installs a portable Python environment
• Executes system-level operations required for eMMC access

The tool is completely safe and open-source. You can review the source code in this repository at any time.

How to Exclude from Windows Defender

To use NAND Fix Pro, you'll need to add an exclusion to Windows Defender:

Method 1: Add Exclusion Before Extracting (Recommended)

1. Open Windows Security by searching for it in the Start menu
2. Click on Virus & threat protection
3. Under "Virus & threat protection settings", click Manage settings
4. Scroll down to Exclusions and click Add or remove exclusions
5. Click Add an exclusion and select Folder
6. Navigate to and select the folder where you plan to extract NAND Fix Pro
7. Now extract the NAND-Fix-Pro-v2.0.0.exe to that folder

Method 2: Restore Quarantined File

If Windows Defender already quarantined the file:

1. Open Windows Security
2. Go to Virus & threat protection
3. Click on Protection history
4. Find the NANDFixPro.exe entry and click on it
5. Click Actions → Restore
6. Then follow Method 1 above to add the folder to exclusions to prevent future detection

Method 3: Using Windows Defender via Settings

1. Press Windows + I to open Settings
2. Go to Privacy & Security → Windows Security
3. Click Virus & threat protection
4. Under "Virus & threat protection settings", click Manage settings
5. Scroll to Exclusions → Add or remove exclusions
6. Click Add an exclusion → Folder
7. Select your NAND Fix Pro installation folder

---

How to Update

1. Download NAND-Fix-Pro-v2.0.0 (self-extracting archive) from the assets below.
2. Double-click the .exe file to extract all contents.
3. Choose your installation directory when prompted.
4. Run NANDFixPro.exe - all dependencies will be installed automatically on first launch.

Note: This is a major version update with significant changes to the workflow. Please read the updated usage guide (Help > Usage Guide) before using new features.

1.0.3

What's New in v1.0.3

New "Help" Menu & Detailed Usage Guide

You no longer need to search for external guides. All the information you need is now built directly into the app.

• New Help Menu: A "Help" menu has been added to the top bar with "Usage Guide" and "About" sections.
• External Guide File: The detailed guide is loaded from lib/docs/usage.txt, making it easy for the community to update and translate without changing the application code.
• Comprehensive Details: The guide provides in-depth explanations for when to use each level, the importance of backups, prerequisites like using Lockpick_RCM, and the consequences of each action (e.g., data loss, loss of online functionality).

New Feature: Advanced USER Partition Fix

A new "Advanced: Fix USER Only" button has been added to the Level 2 tab.

• Targeted Repair: This allows you to completely replace a corrupt USER partition without touching the operating system (SYSTEM) or any other part of the NAND.
• Fast & Efficient: It's perfect for common issues where the console boots but can't access user profiles or data. The process is significantly faster than a full Level 2 rebuild because it only writes the first 100MB of the partition.

---

How to Update

1. Download NAND-Fix-Pro-v1.0.3.zip from the assets below.
2. Extract the contents to replace your existing installation.
3. Run NANDFixPro.exe.

1.0.2

NAND Fix Pro v1.0.2 - The Safety & Clarity Update

This is a major update focused on user safety, process transparency, and consistency across all repair levels. With these changes, you'll have more confidence and clarity from the moment you click "Start."

What's New in v1.0.2

Universal eMMC Detection & Confirmation (Safety First!)

The most important feature of this update is a massive improvement to drive detection safety, which is now consistent across all three levels.

• WMI For All: The robust and reliable WMI drive detection, previously only in Level 3, is now implemented for Level 1 and Level 2.
• Final Confirmation Pop-up: Before any operation begins, a confirmation dialog will now appear for all levels. It displays the details of the detected eMMC (Path, Size, Model) and requires you to approve the action, virtually eliminating the risk of accidentally running a process on the wrong drive.

Live Progress Bars (Know What's Happening)

No more staring at the screen wondering if the script has frozen. A smooth, non-jittering progress bar now provides live feedback for all long-running file operations.

• Visual Feedback: You will now see a [█████-----] XX% progress bar during:
  • All 7-Zip archive extractions (like SYSTEM.7z, donor64.7z, etc.).
  • Large file copy operations, like preparing the NAND skeleton in Level 3.
  • The final raw NAND write to the eMMC in Level 3.

Process Optimizations & Bug Fixes

• Faster Level 3 Write: The optimized raw write for the Level 3 process has been reduced from 5GB to 4GB, speeding up the final step slightly while still covering all essential partitions.
• Critical Threading Fix: Resolved a major bug that could cause the application to freeze or become unresponsive during any of the repair processes. This ensures much greater stability.

Upgrade Notes

• The core repair logic for each level remains unchanged. This update focuses on the user interface, safety checks, and feedback.
• Your config.ini file and saved paths will be preserved.
• Requirements are the same: your own prod.keys file and a firmware folder.

How to Update

1. Download NAND-Fix-Pro-v1.0.2.zip below.
2. Extract the contents to replace your existing installation.
3. Run NANDFixPro.exe.

1.0.1

NAND Fix Pro v1.0.1 - Quality of Life Update

This update focuses on improving user experience and system reliability with several key enhancements based on user feedback.

What's New in v1.0.1

Enhanced Logging System

• Save Log Feature: Export complete session logs with timestamps for troubleshooting and support
• Clear Log Function: Reset the log window during long sessions
• Cleaner Output: Reduced verbose debugging messages for more professional, readable logs

Improved Error Prevention

• Disk Space Validation: Automatic check for 60GB free space before starting any repair level
• Better Error Messages: More descriptive error dialogs with actionable solutions
• Dependency Auto-Install: Automatic installation of required Python packages (WMI) on first run

Flexible Storage Management

• Custom Temp Directory: Set temporary directory to any location on your PC for better storage management
• Improved Storage Control: Choose optimal drive locations based on available space and performance needs

Process Completion Notifications

• Success Popups: Clear completion dialogs for Level 1 and Level 2 processes (Level 3 already had this)
• Consistent User Experience: All three levels now provide the same feedback structure

Bug Fixes

• Fixed critical crash in Level 2 and Level 3 when modifying SYSTEM partitions
• Resolved save log dialog parameter errors
• Improved file path validation and error handling

Upgrade Notes

• All existing configurations and settings are preserved
• No changes to repair logic or compatibility
• Same requirements: your own prod.keys and firmware folder

How to Update

1. Download NAND-Fix-Pro-v1.0.1.zip below
2. Extract to replace your existing installation
3. Run NANDFixPro.exe

The core repair functionality remains unchanged - this update purely enhances the user interface and prevents common user errors.