You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
# fnorm - FixNormalization
2
-
Fix Unicode normalization in filenames.
2
+
Fix Unicode normalization of filename.
3
3
4
4
> [!IMPORTANT]
5
5
> 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.
10
10
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.
11
11
(e.g. 한글 -> 한글). In particular in Hangul, it has been considered really notorious problem among people who need to communicate files with different OSes.
12
12
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...
15
15
16
16
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.
17
17
18
18
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.
19
19
20
-
That's why I made this humble tool.
20
+
That's why I made this simple tool with .NET.
21
21
22
22
## Installation
23
23
@@ -36,7 +36,7 @@ That's because Windows still uses MBCS(Multi-Byte Character Set) as a default en
36
36
But this option can be problematic in some programs which forces or are sticked to specific encoding. (e.g. MapleStory, Fallout: New Vegas)
37
37
You can also make a workaround by type ```chcp 65001``` to set UTF-8 encoding in the console section prior to executing this program.
38
38
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.
40
40
41
41
### Scoop
42
42
@@ -77,10 +77,12 @@ It is still in development that fnorm will support recursive search in directori
77
77
```nfc``` or ```formc```**[Default]**
78
78
79
79
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.
80
81
81
82
```nfd``` or ```formd```
82
83
83
84
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.
84
86
85
87
### ```--recursive``` or ```-r```
86
88
@@ -97,4 +99,4 @@ This software is distributed under MIT License. I don't have any responsibility
97
99
98
100
---
99
101
100
-
Copyright (c) 2024-2025**Capella87**. Distributed under MIT License.
0 commit comments