Hangul Jasofixer

A fast and reliable Windows Forms application to normalize internal file structure of Hangul filenames.

Hangul Jasofixer addresses the issue where Hangul filenames are decomposed into individual Jamo (consonants and vowels) on Windows (NFD), often occurring when files are moved between operating systems (e.g., macOS to Windows). This tool normalizes them back to the composed form (NFC), ensuring compatibility and proper display.

Table of Contents

• Features
• Prerequisites
• Install
• Usage
• Build
• Maintainers
• Contributing
• License

Features

• Normalization: Converts decomposed Hangul (NFD) to composed Hangul (NFC).
• Safety First: Optional automated backup before processing.
• Logging: Detailed change logs with timestamps saved to a file.
• Real-time Progress: Visual progress bar and status updates.
• Cancellation: Ability to safely stop the process at any time.
• Performance: Asynchronous processing with thread safety to keep the UI responsive.
• Robustness: Handles permission errors, duplicate names, and invalid paths gracefully.

Prerequisites

• Windows 7 or higher
• .NET 8.0 Runtime

Install

No installation is required. Simply download the latest release and run the executable.

Usage

1. Run HangulJasofixer.exe (or use the provided run.bat).
2. Click "폴더 선택 및 정규화 시작" (Select Folder & Start Normalization).
3. Choose the directory containing the files you want to fix.
4. Review options:
   • Backup: Enabled by default. Creates a full backup of the target folder.
   • Log: Enabled by default. Saves a text log of all operations.
5. The process will run automatically. You can monitor progress or cancel if needed.

Build

To build from source:

Automatic (Recommended)

.\build.bat

Manual

dotnet restore HangulJasofixer.csproj
dotnet build HangulJasofixer.csproj --configuration Release

Maintainers

• Choi Minseo

Contributing

PRs accepted.

License

MIT © 2025 Choi Minseo