name2win (Name to Windows)

Version 2.2.0 (2026-10-16)

Windows環境でファイル名として使用できない文字や、Zip解凍・古のWin32アプリ（MangaMeeya等）でのファイル操作時にトラブルの原因となる文字をクレンジングし、CP932（Shift_JIS）完全準拠の安全なファイル名に一括置換するC#製CLIツールです。 DiscordやPatreonなどからダウンロードしたファイルのファイル名整理・リネームに最適です。

特徴

• Windowsで使用不可の文字（\ / : * ? " < > |）を全角へ変換
• 波ダッシュ（〜）から全角チルダ（～）への統一
• ラテン文字のダイアクリティカルマーク（é → e など）の除去（※日本語の濁点・半濁点は保護）
• 丸数字の標準化（❶→①、㉑→(21) 等）
• CP932非対応のかな救出: ひらがなの ゔ (U+3094)・小書き ゕ ゖ、およびカタカナの ヷ ヸ ヹ ヺ を、CP932対応の ヴ ヵ ヶ ヴァ ヴィ ヴェ ヴォ へ自動変換
• 記号ファミリー集約: 三角（🔺 ▶ ◀ ▷ ◁ 等→▲ △ ▼ ▽）、ダイヤ（🔶 🔷 🔸 🔹→◆ ◇）、丸（🔴 🔵 ⚫ ⚪→● ○）、星（☆ ✨ ⭐ 🌟→★）、音符（🎵 🎶 🎼 ♩ ♫ ♬→♪）
• 古のWin32アプリ救済 (MangaMeeya対応): Unicode標準のハート（♥/♡）はShift_JIS非対応のため、MangaMeeya等のANSI Win32アプリではファイルを開けません。そのため、ハート系絵文字およびUnicodeハート（♥）は Shift_JIS外字黒ハート（\uE0A5 / 0xF0E6） へ、Unicode白ハート（♡）は Shift_JIS外字白ハート（\uE006 / 0xF046） へ自動変換し、MangaMeeyaで正常に開けるファイル名にします。
• 文字コード診断モード (-c / --check): 指定した文字列やファイル名を1文字ずつ解析し、Unicode / Shift-JIS (CP932) / Win32判定 / 変換結果 を表形式でコンソールに出力
• 外部対応表サポート: name2win.mapping.txt（または .tsv）による自由なカスタム置換（中国語の漢字 ➔ 日本語/カタカナ等の1対多置換、特定絵文字の個別置換など）
• Shift_JIS（CP932）往復検証による非対応文字・絵文字の厳密な単一「■」へのフォールバック
• 重複ファイル名の連番付与、およびMD5ハッシュ比較による完全一致ファイルの自動削除
• 変更箇所の色分け表示（変更前の該当文字: 赤 / 変更後の該当文字: 黄）

コンパイル方法

Windows環境に標準搭載されているC#コンパイラ（.NET Framework csc.exe）でコンパイル可能です。

csc name2win.cs

Note

本ツールは「Windows標準環境のみで自己ビルドできる手軽さ」およびセキュリティの観点から、exe の配布は行っていません。上記の手順でご自身の環境でビルドしてください。

文字コード診断モード (-c / --check)

ファイルが開けない原因文字を即座に特定するためのデバッグ・診断機能です。文字列またはファイルパスを指定すると、1文字ずつCP932互換性を診断して表形式で出力します（ファイル自体のリネームは行いません）。

name2win.exe -c "テスト♬♥♡ゔ▶◀.zip"

注意事項

• 色分け表示と背景色: 変更後の文字は黄色で表示されます。黒背景のターミナル（コマンドプロンプト / PowerShell / Windows Terminal の既定）を想定しているため、白背景のテーマでは黄色が見づらい場合があります。
• 事前確認の推奨: 実際にリネームする前に、-t（テスト実行）オプションで変更内容を確認することをおすすめします。

外部対応表（name2win.mapping.txt）によるカスタマイズ

name2win.exe と同じフォルダー、またはコマンドを実行するフォルダーに name2win.mapping.txt（または .tsv）を配置すると、起動時に自動で読み込まれ、最優先で置換が適用されます。

• 書式: 変換元[Tabまたは=または,]変換先
• コメント: # または // で始まる行は無視されます。
• 1文字 ➔ 複数文字の置換に対応: 中国語（簡体字・繁体字）などのShift_JIS外漢字を、日本語の漢字やカタカナに展開できます。

# 例1: 中国語漢字の日本語化（1対多置換）
酱=ちゃん
哔=ピー
哒=ダ
喵=ミャオ

# 例2: 絵文字の個別カスタマイズ
💛=
🍳=料理

古のWin32アプリがファイル名として読み込める文字リスト（仕様）

MangaMeeyaなどの古のWin32アプリ（内部で CreateFileA / FindFirstFileA 等のANSI APIを使用するアプリ）がファイル名として読み込める文字は、「Windows-31J（CP932 / 拡張Shift-JIS）にコードポイントが存在する文字」と完全に一致します。 CP932に存在しないUnicode文字は、OSのAPI変換時にすべて 0x3F（半角の ?＝ワイルドカード予約文字）に化けるため、ファイルオープン時にエラーになります。

1. 記号・かな・特殊文字の対応表（クレンジング変換先・通過可能記号）

文字	Shift-JIS	Unicode	備考
	F0E6	U+E0A5	外字黒ハート。変換元対象：♥ (U+2665), ❤️ (U+2764), ハート系絵文字群 (U+1F493〜U+1F49F, U+1F970, U+1FA75〜U+1FA77 等)
	F046	U+E006	外字白ハート。変換元対象：♡ (U+2661)
♪	81F4	U+266A	八分音符。変換元対象：♩ (U+2669), ♫ (U+266B), ♬ (U+266C), 音符絵文字 (U+1F3B5 🎵, U+1F3B6 🎶, U+1F3BC 🎼) ※CP932にある音符は ♪ のみ
♭	81F3	U+266D	フラット（そのまま通過可能）
♯	81F2	U+266F	シャープ（そのまま通過可能）
★	819A	U+2605	黒星。変換元対象：☆ (U+2606), ✨ (U+2728), ⭐ (U+2B50), 星絵文字 (U+1F31F 🌟, U+1F320 🌠, U+1F4AB 💫)
☆	8199	U+2606	白星（CP932に存在し読み込み可能。クレンジング時は ★ へ集約）
▲	81A3	U+25B2	上向き黒三角。変換元対象：🔺 (U+1F53A), ▶ (U+25B6), ▴ (U+25B4), ▸ (U+25B8), ► (U+25BA)
△	81A2	U+25B3	上向き白三角。変換元対象：▷ (U+25B7), ▵ (U+25B5), ▹ (U+25B9), ▻ (U+25BB)
▼	81A5	U+25BC	下向き黒三角。変換元対象：🔻 (U+1F53B), ◀ (U+25C0), ▾ (U+25BE), ◂ (U+25C2), ◄ (U+25C4)
▽	81A4	U+25BD	下向き白三角。変換元対象：◁ (U+25C1), ▿ (U+25BF), ◃ (U+25C3), ◅ (U+25C5)
◆	819F	U+25C6	黒ダイヤ。変換元対象：🔶 (U+1F536), 🔷 (U+1F537)
◇	819E	U+25C7	白ダイヤ。変換元対象：🔸 (U+1F538), 🔹 (U+1F539)
●	819C	U+25CF	黒丸。変換元対象：⚫ (U+26AB), 🔴 (U+1F534), 🔵 (U+1F535), カラー丸絵文字 (U+1F7E0〜U+1F7E4)
○	819B	U+25CB	白丸。変換元対象：⚪ (U+26AA)
◎	819D	U+25CE	二重丸（そのまま通過可能）
◯	81FC	U+25EF	大きな丸（そのまま通過可能）
■	81A1	U+25A0	黒四角（豆腐フォールバック先）。CP932非対応のすべての絵文字・特殊文字の最終変換先
□	81A0	U+25A1	白四角（そのまま通過可能）
♀	818A	U+2640	メス記号（そのまま通過可能）
♂	8189	U+2642	オス記号（そのまま通過可能）
ヴ / ヵ / ヶ	8394〜8396	U+30F4	CP932非対応かなの救出先。ゔ (U+3094) ➔ ヴ、ゕ (U+3095) ➔ ヵ、ゖ (U+3096) ➔ ヶ、ヷ〜ヺ (U+30F7〜U+30FA) ➔ ヴァ〜ヴォ
①	8740	U+2460	丸数字 ①〜⑳（Shift-JIS 8740〜8753 / Unicode U+2460〜U+2473 の連続20文字）。変換元対象：黒丸数字 ❶〜❿ (U+2776〜U+277F), ⓫〜⓴ (U+2780〜U+2789) ※㉑以降はCP932非対応のため半角 (21)〜(50) へ展開
Ⅰ	8754	U+2160	大文字ローマ数字 Ⅰ〜Ⅹ（Shift-JIS 8754〜875D / Unicode U+2160〜U+2169 の連続10文字）
ⅰ	FA40	U+2170	小文字ローマ数字 ⅰ〜ⅹ（Shift-JIS FA40〜FA49 / Unicode U+2170〜U+2179 の連続10文字）
～	8160	U+FF5E	全角チルダ。変換元対象：波ダッシュ 〜 (U+301C ※CP932非対応), 波線絵文字 〰 (U+3030)
∥ / ￠ / ￡ / ￢	8161 / 8191 / 8192 / 81CA	U+2225	macOS(JIS)⇄Windows(CP932)マッピング不一致記号の救出先。‖ (U+2016) ➔ ∥、¢ (U+00A2) ➔ ￠、£ (U+00A3) ➔ ￡、¬ (U+00AC) ➔ ￢
－	817C	U+FF0D	Windows全角ハイフンマイナス。変換元対象：macOS等で全角として扱われるハイフン・ダッシュ・マイナス類（全9種）‐ (U+2010), — (U+2014 EMダッシュ), ― (U+2015 全角ダッシュ), − (U+2212 全角マイナス), ﹘ (U+FE58), ﹣ (U+FE63), ⸺ (U+2E3A), ⸻ (U+2E3B), ゠ (U+30A0)
-	2D	U+002D	半角ハイフン。変換元対象：欧文・半角系ハイフン・ダッシュ類（全4種）‑ (U+2011), ‒ (U+2012), – (U+2013 ENダッシュ), ⁃ (U+2043) ※不可視のソフトハイフン (U+00AD) は自動削除
'	27	U+0027	半角シングルクォート。変換元対象：‘ (U+2018), ’ (U+2019), ‚ (U+201A), ‛ (U+201B)
／	815E	U+FF0F	Windows禁止文字 / (U+002F) の変換先
＼	815F	U+FF3C	Windows禁止文字 \ (U+005C) の変換先
：	8146	U+FF1A	Windows禁止文字 : (U+003A) の変換先
＊	8196	U+FF0A	Windows禁止文字 * (U+002A) の変換先
？	8148	U+FF1F	Windows禁止文字 ? (U+003F) の変換先
”	8168	U+201D	Windows禁止文字 " (U+0022) の変換先
＜	8183	U+FF1C	Windows禁止文字 < (U+003C) の変換先
＞	8184	U+FF1E	Windows禁止文字 > (U+003E) の変換先
｜	8162	U+FF5C	Windows禁止文字 `

2. 一般文字ブロックの対応表（CP932でそのまま読み込める全範囲）

文字（代表・先頭）	Shift-JIS	Unicode	備考
〜 ~	20〜7E	U+0020	半角英数字・記号（ASCII 95文字） ※ただしファイル名禁止9文字 \ / : * ? " < > | を除く
｡ 〜 ﾟ	A1〜DF	U+FF61	半角カタカナ・半角句読点（U+FF61〜U+FF9F の連続63文字）
（全角空白等）	8140〜81FC	U+3000	JIS非漢字（句読点・括弧・学術記号） ※上表の ★ ♪ ■ ● ▲ ◆ 等もすべてこの 81xx 領域に所属
０ / Ａ / ａ	824F〜829A	U+FF10	全角数字・全角英字（０〜９: U+FF10〜U+FF19, Ａ〜Ｚ: U+FF21〜U+FF3A, ａ〜ｚ: U+FF41〜U+FF5A）
ぁ 〜 ん	829F〜82F1	U+3041	ひらがな（U+3041〜U+3093 の83文字 ※ゔ U+3094 等はCP932非対応のため ヴ 等へ変換）
ァ 〜 ヶ	8340〜8396	U+30A1	全角カタカナ（U+30A1〜U+30F6 の86文字 ※ヷ〜ヺ U+30F7〜U+30FA はCP932非対応のため ヴァ〜ヴォ へ変換）
Α / α	839F〜83D6	U+0391	ギリシャ文字（大文字 U+0391〜U+03A9, 小文字 U+03B1〜U+03C9）
А / а	8440〜8491	U+0410	キリル文字（ロシア文字）（大文字 U+0410〜U+042F, Ё U+0401, 小文字 U+0430〜U+044F, ё U+0451）
─ 〜 ╂	849F〜84BE	U+2500	罫線素片（U+2500〜U+254B のうち32文字。二重罫線 ═ 等はCP932非対応）
① / ㍉ / ㈱	8740〜879C	U+2460	NEC特殊文字（①〜⑳, Ⅰ〜Ⅹ, 組文字 ㍉ ㌔ ㌢ ㍍ ㌘ ㍻ ㈱ ㈲ ㈹, 数学記号 ≒ ≡ ∫ √ 等）
亜 〜 熙	889F〜EAA4	U+4E9C	JIS第1水準・第2水準漢字（計6,355字）
纊 〜 黑	FA40〜FC4B	U+7E8A	IBM拡張文字・漢字（ⅰ〜ⅹ, 髙 [U+9AD9/FBFC], 﨑 [U+FA11/F9F5], ㈱ 等388字）
 〜 	F040〜F9FC	U+E000	外字領域（全1,880文字）。Unicode私用領域 U+E000〜U+E757 と1対1で連続対応。黒ハート U+E0A5 (F0E6)・白ハート U+E006 (F046) もここに含まれる

3. 多言語・OS間互換問題の対応仕様（macOS・漢字・ハングル・西欧文字）

分類	対象・問題の内容	本ツールの対応仕様
macOSとの全半角ダッシュ・ハイフン・波ダッシュ問題	・macOSとWindows(CP932)では、JIS X 0208 ⇄ Unicode の変換テーブル定義が異なる7大不一致文字が存在し、macOS側で入力された文字がWindowsのCP932で 0x3F (?) に化ける。 ・またmacOSのIMEや欧文フォント・PDF等では、全角系ダッシュと欧文半角系ハイフンが混在する。	【完全網羅・全半角区別救出済】 1. 波ダッシュ・波線: 〜 (U+301C), 〰 (U+3030) ➔ 全角チルダ ～ (U+FF5E / SJIS 8160) 2. 全角系ハイフン・ダッシュ・マイナス類 (全9種): ‐ (U+2010), — (U+2014 EMダッシュ), ― (U+2015 全角ダッシュ), − (U+2212 全角マイナス), ﹘ (U+FE58), ﹣ (U+FE63), ⸺ (U+2E3A), ⸻ (U+2E3B), ゠ (U+30A0) ➔ Windows全角ハイフンマイナス － (U+FF0D / SJIS 817C) に統一 3. 半角・欧文系ハイフン・ダッシュ類 (全4種): ‑ (U+2011), ‒ (U+2012), – (U+2013 ENダッシュ), ⁃ (U+2043) ➔ 半角ハイフン - (U+002D / SJIS 2D) に統一（※不可視のソフトハイフン U+00AD は削除、日本語長音 ー U+30FC・半角 ｰ U+FF70 はそのまま保持） 4. 残りのJIS/CP932不一致4記号: ‖ (U+2016) ➔ ∥ (U+2225/8161)、¢ (U+00A2) ➔ ￠ (U+FFE0/8191)、£ (U+00A3) ➔ ￡ (U+FFE1/8192)、¬ (U+00AC) ➔ ￢ (U+FFE2/81CA)
漢字コード（日本語）	・JIS第1・第2水準（6,355字）およびIBM拡張漢字（髙 﨑 等360字）はCP932対応。 ・一方、macOSやPDFからのコピペで混入する康熙部首（U+2F00〜U+2FD5）・CJK部首補助（U+2E80〜U+2EFF）（例：⼀ U+2F00 等）は、見た目が通常の漢字（一 U+4E00）と全く同じなのにCP932非対応で開けない罠がある。 ・JIS第3・第4水準固有の漢字（CP932外）もWin32では開けない。	【完全対応済】 1. JIS第1・第2水準＋IBM拡張漢字: そのまま無変換で通過。 2. 康熙部首・CJK部首補助 (U+2E80〜U+2FD5): NFKC正規化により、見た目が同じ通常のJIS漢字（一 人 日 月 等）へ自動救出。 3. JIS第3・第4水準等のCP932外漢字: name2win.mapping.txt に登録があれば優先置換し、未登録のものはCP932検証で安全に ■ へ変換。
漢字コード（繁体字中国語）	・台湾・香港等の標準繁体字（Big5 全13,051字）のうち、常用第1水準（5,401字）の82.7%にあたる 4,469字（國 學 體 龍 灣 愛 個 等）はCP932に存在する。 ・残りの常用第1水準 932字（妳 們 這 說 嗎 呢 等、次常用第2水準を含めると計7,526字）はCP932に存在しない。	【完全対応済】 ・CP932（JIS第1・第2水準・IBM拡張）に含まれる繁体字はそのまま通過。 ・CP932に存在しない繁体字固有文字は、name2win.mapping.txt でカスタム置換（說=説, 妳=女尓, 們=ｲ門 等）するか、CP932検証により100%確実に ■ へフォールバック。
漢字コード（簡体字中国語）	・中国大陸の簡体字固有の文字（酱 哔 哒 们 这 个 爱 发 龙 等）はCP932に存在せず、そのままではWin32アプリで ? に化けて開けない。	【完全対応済】 ・name2win.mapping.txt による1対多の日本語化（例：酱=ちゃん）をサポート。 ・対応表にない簡体字も、CP932検証により100%漏れなく ■ へフォールバックし、ファイルオープン不能を防止。
ハングル（韓国語）	・ハングル完成形（U+AC00〜U+D7AF 全11,172字）およびハングル字母（U+1100〜U+11FF, U+3130〜U+318F）は、日本語CP932に1文字も収録されておらず、すべてWin32アプリで開けない。	【完全対応済】 ・CP932厳密検証により、すべてのハングル文字を100%確実に検出して ■ へフォールバック（name2win.mapping.txt によるカタカナ等への任意置換も可）。
西欧文字コード（ダイアクリティカルマーク・特殊ラテン文字）	・フランス語・ドイツ語・スペイン語・北欧語等のアクセント付き文字（é à ü ñ ç 等）はCP932に存在しない。 ・さらに ß（独エスツェット）、Æ/æ、Œ/œ、Ø/ø、Ł/ł、Đ/đ、Þ/þ、Ð/ð 等の合字・ストローク付き文字は、Unicode NFD分解でもベース文字と記号に分解されないため、通常のアクセント除去では ■ に潰れてしまう。	【完全網羅・ASCII展開済】 1. 合字・ストローク付きラテン文字の事前展開: ß➔ss, ẞ➔SS, Æ➔AE, æ➔ae, Œ➔OE, œ➔oe, Ø➔O, ø➔o, Ł➔L, ł➔l, Đ/Ð➔D, đ/ð➔d, Þ➔TH, þ➔th へ自動展開。 2. ダイアクリティカルマーク（発音区別符号）の除去: NFD分解によりラテン文字の結合アクセント記号（U+0300〜U+036F 等）のみを除去し、可読性を保ったまま半角ASCII英字（pokémon ➔ pokemon）へ変換（※日本語の濁点 U+3099・半濁点 U+309A は完全保護してNFC再結合）。

なぜ C# 5.0 を採用したのか？

本ツールは最新のC#言語仕様ではなく、あえて C# 5.0 で記述されています。これには実務上の強力な理由があります。

• 開発環境（IDE）の追加インストールが一切不要 Windows 11 には標準で .NET Framework とコンパイラ（csc.exe）が内蔵されています。Visual Studio などをインストールする必要はありません。
• 厳格な職場環境への適応 「指定されたアプリ・ツール以外はインストール禁止」という厳しいセキュリティ環境であっても、ソースコード（テキスト）さえ持ち込めれば動作させることができます。印刷物からメモ帳に打ち込むだけでも、Excel VBAマクロを作成するような手軽な感覚でコンパイル・導入が可能です。

バージョン履歴 (Changelog)

• v2.2.0:
  • 全角系ハイフン・ダッシュの変換先仕様変更: macOSでも全角として認識されるハイフン・ダッシュ・マイナス類（‐ U+2010, — U+2014, ― U+2015, − U+2212, ﹘ U+FE58, ﹣ U+FE63, ⸺ U+2E3A, ⸻ U+2E3B, ゠ U+30A0 の9種）を Windows全角ハイフンマイナス － (U+FF0D / CP932 817C) に変換し、欧文・半角系ハイフン（‑ U+2011, ‒ U+2012, – U+2013, ⁃ U+2043 の4種）のみを半角 - (U+002D) に変換するよう精緻化。
• v2.1.0:
  • macOSダッシュ・ハイフン・JIS不一致記号の完全網羅: 全13種のUnicodeハイフン・ダッシュ・マイナス類の救出、ソフトハイフン（U+00AD）の除去、波線 〰 (U+3030) の ～ 化、および JIS/CP932 マッピング不一致記号（‖➔∥, ¢➔￠, £➔￡, ¬➔￢）の救出を追加。
  • 西欧合字・ストローク付き文字の展開 & 康熙部首の標準漢字救出: NFDで分解されない西欧文字（ß➔ss, æ➔ae, ø➔o 等）のASCII展開、およびmacOS/PDF由来の康熙部首・CJK部首補助（U+2E80〜U+2FD5）を標準JIS漢字へ正規化する処理を追加。
• v2.0.0:
  • 文字コード診断モード (-c / --check) の追加: 指定した文字列やファイル名を1文字ずつ解析し、Unicode・Shift-JIS(CP932)・Win32互換性判定・変換結果を一覧表で出力するデバッグ機能を実装。
  • CP932非対応のかな・三角記号・音符の救出強化: ゔ (U+3094)・ゕ・ゖ・ヷ〜ヺ を ヴ・ヵ・ヶ・ヴァ〜ヴォ へ救出、右・左・小三角（▶ ◀ ▷ ◁ 等）を ▲ △ ▼ ▽ へ集約、♬ (U+266C)・♩ (U+2669) を ♪ (81F4) へ統合、および全文字に対する Encoding.GetEncoding(932) 往復検証の完全適用。
• v1.5.3: MangaMeeya等の古のWin32 ANSIアプリがUnicode標準ハート（♥/♡）を読めずエラーになる問題を根本解決。ハート系絵文字およびUnicodeハート（♥）を Shift_JIS外字黒ハート（\uE0A5 / 0xF0E6） へ、Unicode白ハート（♡）を Shift_JIS外字白ハート（\uE006 / 0xF046） へ自動変換するよう改修（既存の ♥ / ♡ 付きファイル名も再実行で自動修正）。
• v1.5.0: 外部対応表（name2win.mapping.txt / .tsv）のサポートを追加（1文字対複数文字の置換に対応）。幾何学図形絵文字（三角、ダイヤ、丸）の標準集約を追加。
• v1.4.3: コンソール出力に差分ハイライト機能を追加。変更・削除された文字（赤）と追加された文字（黄）を色分けして視認性を向上。
• v1.4.2: 異体字セレクタ（VS15, VS16: U+FE0E, U+FE0F）を不可視文字として除去対象に追加。
• v1.4.1: 波ダッシュ（〜 → ～）の是正を追加。
• v1.4.0: 丸数字の標準化（❶→①, ㉑→(21)）および記号ファミリーの集約（♥, ★, ♪への統一）を実装。
• v1.3.0: macOS特有の不可視ゴミ文字の除去、およびダッシュ類（EN DASH, EM DASH等）の標準化処理を追加。
• v1.2.0: Unicode NFC正規化処理を追加。日本語の濁点・半濁点を保護しつつ、ラテン文字のダイアクリティカルマークを安全に除去。
• v1.1.0: Shift_JIS (CP932) 非対応文字の安全なフォールバック機能（サロゲートペアや絵文字を ■ に置換）を追加。
• v1.0.0: 初期リリース。Windowsの禁止文字置換と重複ファイル処理の基本機能を実装。