Skip to content

Commit c820046

Browse files
authored
Update README.md
1 parent a6e1b31 commit c820046

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

README.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# fnorm - FixNormalization
2-
Fix Unicode normalization in filenames.
2+
Fix Unicode normalization of filename.
33

44
> [!IMPORTANT]
55
> This software is in development. It may contains unknown or potential bugs and unexpected behaviors. If you find or encounter those, Open an issue at this repository and describe it.
@@ -10,14 +10,14 @@ Fix Unicode normalization in filenames.
1010
It is especially useful when you met <ins>a nasty messed filename</ins> including characters which can be decomposed after moving files from macOS (or Darwin based-OSes) to Windows or Linux.
1111
(e.g. 한글 -> ᄒ​ᅡ​ᆫᄀ​ᅳ​ᆯ). In particular in Hangul, it has been considered really notorious problem among people who need to communicate files with different OSes.
1212

13-
This problem is derived from discrepancy in processing Unicode characters between Darwin (**macOS**, iPadOS, iOS, tvOS, watchOS, visionOS) and others, because HFS+, a filesystem that once Apple had been applied in their OSes, uses Normalization D to save filenames in UTF-16.
14-
Although APFS(Apple File System), a newer file system recognizes and preserves normalization types, but files or directories created in those environments still have Form-D typed filename. This is why the problem persists...
13+
This problem is derived from discrepancy in processing Unicode characters between Darwin (**macOS**, iPadOS, iOS, tvOS, watchOS and visionOS) and others, because HFS+, a filesystem that Apple had conducted in their OSes, uses Normalization D to save filename in UTF-16.
14+
Although APFS(Apple File System), a newer file system can recognize and keep filename's normalization types, but files or directories created in those environments still have Form D filename. This is why the problem persists...
1515

1616
Other characters, such as diacritics, they seem to be shown correctly with subtly behavior in Windows anyway, but Hangul characters are NOT at all. Read [an article](https://devblogs.microsoft.com/oldnewthing/20201009-00/?p=104351) regarding this issue in detail.
1717

1818
Although this is a file system problem and limited to only filename, so manual renaming is a solution, but it is really time-consuming when you have a lot of files.
1919

20-
That's why I made this humble tool.
20+
That's why I made this simple tool with .NET.
2121

2222
## Installation
2323

@@ -36,7 +36,7 @@ That's because Windows still uses MBCS(Multi-Byte Character Set) as a default en
3636
But this option can be problematic in some programs which forces or are sticked to specific encoding. (e.g. MapleStory, Fallout: New Vegas)
3737
You can also make a workaround by type ```chcp 65001``` to set UTF-8 encoding in the console section prior to executing this program.
3838

39-
I recommend to run the program in Windows Terminal with PowerShell 7.
39+
I recommend to run this program in Windows Terminal with PowerShell 7.
4040

4141
### Scoop
4242

@@ -77,10 +77,12 @@ It is still in development that fnorm will support recursive search in directori
7777
```nfc``` or ```formc``` **[Default]**
7878

7979
Convert filenames to follow Normalization Form C. If you don't specify ```--form``` option, it will be automatically set to ```nfc```.
80+
Windows and Linux normally use this form.
8081

8182
```nfd``` or ```formd```
8283

8384
Convert filenames to follow Normalization Form D. In general cases you don't have to care about this option.
85+
macOS or any Apple's operating systems are using this form.
8486

8587
### ```--recursive``` or ```-r```
8688

@@ -97,4 +99,4 @@ This software is distributed under MIT License. I don't have any responsibility
9799

98100
---
99101

100-
Copyright (c) 2024-2025 **Capella87**. Distributed under MIT License.
102+
Copyright © 2024-2026 **Capella87**. Distributed under MIT License.

0 commit comments

Comments
 (0)