Skip to main content

Restore Sanitized Bundle Folder Names (Mac & Windows)

Special characters are removed for compatibility — here’s how to restore them after download

Updated this week

When generating a bundle, Snapizzi intentionally sanitizes the subject gallery folder names inside the ZIP file to ensure compatibility across operating systems. This only affects the downloaded ZIP — not your project data or what’s displayed inside Snapizzi.

Example:
Accents and special characters like é, ñ, or ç may be removed to prevent issues when opening ZIPs on certain systems. Any characters outside the standard set [a–z, A–Z, 0–9, _ , -] are removed during ZIP creation.

This avoids problems on platforms that don’t fully support UTF-8 folder names inside ZIP files. Your original folder names with accents and special characters continue to display properly inside the Snapizzi UI and are stored correctly. Only the folder names in the ZIP bundle are affected.


Fixing It: Restore Folder Names Using Your CSV File

We’ve created free tools for both Mac and Windows that use your original CSV file to automatically rename the sanitized folders back to their correct names — including accents and special characters.


macOS Instructions

2. Open and Use It

  • Unzip and move the app to your Desktop or Applications folder

  • Right-click > Open (only the first time to bypass Gatekeeper)

  • Follow the prompts:

    1. Select your unzipped Bundle folder

    2. Select the CSV file you uploaded to Snapizzi

The app will:

  • Rename the subject gallery folders using exact and fuzzy matching

  • Restore accents and special characters

  • Save a log (rename_log.txt) to your Desktop

🛑 Gatekeeper Block?

If macOS prevents the app from launching:

  1. Go to System Settings > Privacy & Security

  2. Click “Open Anyway” under the app block

  3. Relaunch the app



Windows Instructions

2. Run the Script

  • Unzip the folder

  • Double-click snapizzi_folder_fixer_windows.py
    (Requires Python installed)

The script will:

  • Prompt you to select the unzipped bundle folder and CSV file

  • Rename folders using fuzzy matching

  • Save a rename_log.txt file to your Desktop


Best Practices

  • Always keep a copy of your original CSV file — it's your best tool for recovery and fixing folder names.

Did this answer your question?