Paradox-Interactive_music_MOD_support

About this app

# Paradox Interactive Music MOD Support Tool (OGG File Renamer) Paradox Interactive製ゲーム（HoI4, EU4, CK3等）の音楽MOD作成を支援するGUIツールです。 日本語の音楽ファイルをゲームで扱える形式（英数字）に一括リネームし、ゲーム内で元の日本語タイトルを表示するためのローカライズファイル（`.yml`）を自動生成します。 ## 🌟 主な機能 - **自動ローマ字変換**: 日本語（漢字・ひらがな・カタカナ）を、ゲームが認識可能な英数字（ローマ字）に一括変換します。 - **ドラッグ&ドロップ対応**: ファイルやフォルダを直接画面にドロップして素早く読み込めます。 - **高度な一括編集**: - 接頭辞（prefix）の一括追加。 - 正規表現（Regex）を使用した置換。 - 重複したファイル名の自動連番解消機能。 - **文字数チェック**: ファイル名が長すぎるとゲームで認識されないため、制限（デフォルト63文字）を超えた場合に警告を表示します。 - **プレビュー再生**: リネーム前に、元の音声ファイルをワンクリックで再生して内容を確認できます。 - **YAML生成**: 変換前後のファイル名を紐付けた `_l_japanese.yml` を自動生成します。 - **安全なコピー**: 元ファイルを書き換えす、指定したフォルダにリネームしたコピーを作成します。 - **設定の永続化**: 文字数制限や出力先、正規表現の設定などを次回起動時まで保持します。 ## 🚀 使い方 1. **ファイル読み込み**: 画面上のボタン、またはファイル/フォルダを直接画面にドラッグ&ドロップしてOGGファイルを読み込みます。 2. **プレビューと調整**: - 一覧に表示された「変換後のファイル名」を確認します。 - 赤くハイライトされている行は問題（文字数超過や名前重複）があります。ダブルクリックして直接編集するか、一括編集ツールで修正してください。 - 「▶️」をクリックすると元の音声を再生できます。 3. **リネーム実行**: 「リネーム実行」ボタンを押すと、出力フォルダに変換後のOGGファイルとローカライズ用の `.yml` ファイルが生成されます。 4. **仕上げ**: - 生成されたファイルをMODの `music` フォルダ等に配置します。 - 音楽の定義（`.txt` ファイル）を作成する際は、[Music Mod Creation Tool](https://runite-drill.github.io/music-mod-creation-tool/) に本ツールで生成したファイルをセットすることで、簡単にMODを完成させることができます。 ## 🛠 動作環境 - Python 3.10以上推奨 - 依存ライブラリ: - `PySide6` (Qt GUI) - `pykakasi` (ローマ字変換用) - `PyYAML` (YAML生成用) ## 📁 設定ファイル 実行ファイルまたはスクリプトと同じ階層の `settings/` フォルダに設定が保存されます。 - `config.json`: 文字数制限や接頭辞などのアプリケーション設定。 - `forbidden_chars.json`: ローマ字変換時に「_」に置換される禁止文字のリスト。 ## 📦 ビルド方法 (exe化) `PyInstaller` を使用して、Pythonがインストールされていない環境でも動作する実行ファイルを作成できます。 ```powershell pip install pyinstaller pyinstaller --onefile --noconsole --icon icon.ico --name "OGG File Renamer" --collect-data pykakasi gui_app.py ``` ビルドが完了すると `dist/` フォルダに実行ファイルが生成されます。 --- Developed by [Ikumyon](https://github.com/Ikumyon)