🎚️ Audio Gain Adjuster

🎯 概要

このツールは、WAV/FLAC/ALACファイルの音量（ゲイン）を調整するシンプルなツールです。-10dB～+10dBの範囲で音量を増減できます。元のファイル形式（ビット深度・サンプリングレート）を完全に保持したまま、ゲイン調整のみを行います。

✨ 主な特徴

シンプルな操作 - ファイルをドロップして、調整ゲイン値(+1.0, -1.5 等)を入力するだけ
複数ファイル対応 - 単一ファイルまたは複数ファイルを同時に処理可能
個別ゲイン設定 - 各ファイルごとに異なるゲイン値を指定可能
クリッピング自動調整 - クリッピング検出時に自動的に最大安全ゲインで処理
メタデータ保持 - タグ情報・カバー画像を完全保存
3フォーマット対応 - WAV/FLAC/ALAC (.m4a)に対応
ゲイン範囲 - -10dB～+10dBの調整が可能

📌 特記事項

ALAC処理: ALAC (.m4a)ファイルの処理にはffmpegが必要です（PATH登録またはEXEと同フォルダに配置）
元ファイル保護: 元のファイルは一切変更されません。調整後のファイルは新規作成されます

📦 配布ファイル

ファイル名	説明
`gain_adjuster.exe`	実行ファイル（約22MB）
`gain_adjuster_ReadMe.html`	使用説明書（このファイル・日本語版）

注意: 本ツールのインストール作業はありません。EXEファイルを任意の場所に置くだけで使用できます。

📋 動作環境

項目	内容
OS	Windows 10以降
WAV/FLAC処理	EXE単体で動作（追加ソフト不要）
ALAC処理	ffmpegが必要（PATH登録または同フォルダに配置）

ffmpegについて（ALAC処理用）

ALAC (.m4a)ファイルを処理する場合、ffmpegが必要です：

方法1: ffmpegをシステムのPATHに登録（推奨）
方法2: ffmpeg.exeを gain_adjuster.exe と同じフォルダに配置

ffmpegのダウンロード: https://ffmpeg.org/download.html

📊 対応ファイル形式

項目	内容
対応フォーマット	WAV (8/16/24/32bit)、FLAC、ALAC (.m4a)
ビット深度	入力ファイルと同じビット深度で出力（変換なし）
サンプリングレート	入力ファイルと同じレートで出力（再サンプリングなし）
チャンネル数	任意（モノラル、ステレオ、マルチチャンネル対応）

各フォーマットの詳細

WAV

ビット深度: 8/16/24/32bit（整数・浮動小数点）
サンプリングレート: 任意（入力と同じレートで出力）
メタデータ: ID3タグ、RIFF INFOタグ
処理: 直接読み書き（最速）

FLAC

ビット深度: 16/24bit（ロスレス圧縮）
サンプリングレート: 任意（入力と同じレートで出力）
メタデータ: Vorbis Comment + カバー画像
処理: soundfileライブラリ使用

ALAC (.m4a)

ビット深度: 16/24bit（Apple Lossless）
サンプリングレート: 任意（入力と同じレートで出力）
メタデータ: MP4タグ（iTunes形式）
処理: ffmpeg経由でWAVに変換して処理

🚀 使い方

基本的な使用方法

オーディオファイル（単一または複数）を gain_adjuster.exe にドラッグ&ドロップ
コンソールウィンドウが開き、ファイル数が表示されます
各ファイルごとにゲイン調整値を入力（例: -2.5 または +3.0）
Enterキーを押すと処理が開始されます
処理が完了すると、元のファイルと同じ場所に新しいファイルが作成されます
すべてのファイル処理後、サマリーが表示されます

💡 ゲイン値の入力例：

-2.5 - 2.5dB下げる
+3.0 - 3.0dB上げる
1.5 - 1.5dB上げる（+記号は省略可能）
-5dB - 5dB下げる（dB表記も可能）

複数ファイル処理の例

Found 3 valid file(s)
============================================================
File 1/3: song1.wav
Enter gain adjustment value: -1.5
✓ Completed successfully

File 2/3: song2.flac
Enter gain adjustment value: +2.0
WARNING: Clipping detected at +2.0dB!
Auto-adjusting to maximum safe gain: +1.2dB
✓ Completed with auto-adjusted gain (+1.2dB)

File 3/3: song3.m4a
Enter gain adjustment value: +0.5
✓ Completed successfully

SUMMARY
============================================================
Processed: 3/3 files

Auto-adjusted files:
  - song2.flac: +2.0dB → +1.2dB

📊 処理仕様

項目	仕様
ゲイン調整範囲	-10dB ～ +10dB
クリッピング保護	あり（自動検出&自動調整）
メタデータ	完全保持（タグ・カバー画像含む）

📁 出力ファイル

処理されたファイルは以下の命名規則で保存されます：

ファイル名の例

元のファイル: music.wav
-2.5dB調整後: music_-2.5dB.wav
+3.0dB調整後: music_+3.0dB.wav

各フォーマットの出力例

WAV: original_+2.0dB.wav
FLAC: original_-1.5dB.flac
ALAC: original_+3.0dB.m4a

⚠️ クリッピング自動調整機能

ゲインを上げすぎてクリッピング（音割れ）が発生する場合、自動的に最大安全ゲイン値で処理されます。

クリッピング自動調整の動作例

Enter gain adjustment value: +5.0

Processing...
WARNING: Clipping detected at +5.0dB!
Peak level would be: +2.35dB over 0dBFS
Auto-adjusting to maximum safe gain: +2.5dB
  Peak level: 0.998 (OK)

✓ Completed with auto-adjusted gain (+2.5dB)

利点:

クリッピングを完全に回避
可能な限り高いゲインを適用
再実行不要
処理が途中で止まらない

❓ トラブルシューティング

「ffmpeg not found」エラーが出る（ALAC処理時）

原因: ALAC (.m4a)ファイルの処理にffmpegが見つかりません。

解決方法:

ffmpegをシステムのPATHに登録する
または、ffmpeg.exeをgain_adjuster.exeと同じフォルダに配置する

処理が遅い

原因と対策:

ALAC処理: ffmpeg変換が含まれるため、他の形式より時間がかかります（正常動作）
大容量ファイル: 処理時間はファイルサイズに比例します
複数ファイル: 順次処理のため、ファイル数×処理時間がかかります

🎓 技術仕様

ゲイン計算: リニアゲイン（10^(dB/20)）による正確な音量調整
演算精度: float64（倍精度浮動小数点）で高精度処理
音質劣化: 同一ビット深度・サンプリングレートでの処理のため、理論上の音質劣化なし

🔒 セキュリティ情報

VirusTotal スキャン結果

このEXEファイルは第三者機関VirusTotalでスキャン済みです：

判定: 3/72 検出（誤検知 - False Positive）
スキャン結果URL: VirusTotal結果を確認

検出エンジン（3個）:

Bkav - Pro W64.AIDetectMalware
Jiangmin - Trojan.Generic.hunjo
Zillya - Trojan.Blank.Script.976

誤検知について:

主要なセキュリティソフト（Windows Defender、Kaspersky、Avast、AVG、Avira、ESET-NOD32、McAfee、Norton、Symantec等）では検出されません
72個中69個のエンジンが「安全」と判定しています
悪意のあるコードは一切含まれていません
PythonスクリプトをEXE化したツールに対する一部エンジンの誤検知パターンです

⚠️ ダウンロード時の警告について

ブラウザが「危険なファイル」と警告する場合がありますが、これは誤検知です。

Chrome の場合:

ダウンロードバーに「危険なファイル」と表示される
ファイル名の右にある「^」をクリック
「継続」または「保持する」をクリック

Microsoft Edge の場合:

「このファイルは安全にダウンロードできません」と表示される
「...」(詳細)をクリック
「保持する」をクリック

⚠️ 初回実行時の警告について

Windows Defender(SmartScreen)が警告を表示する場合がありますが誤検知です:

「WindowsによってPCが保護されました」と表示される
「詳細情報」をクリック
「実行」ボタンをクリック

📄 免責事項

使用に関する注意事項

本ツールの使用は自己責任でお願いします。
音声ファイルの処理により発生した音質の変化や損失について、開発者は一切の責任を負いません。
商用利用に関しては、関連する著作権法や使用許諾契約を遵守してください。
本ツールの動作により生じたいかなる損害についても、開発者は一切責任を負いません。

📄 ライセンス

このツールは自由に配布・使用できます。

🧑‍💻 開発者情報

開発者	Noriya
Email	noriyahd28v@gmail.com
URL	http://noriya.info/

本ツールは音楽愛好家の皆様により良い音楽体験を提供することを目的として開発されました。
ご質問やフィードバックがございましたら、上記連絡先までお気軽にお寄せください。

Audio Gain Adjuster - Universal Audio Volume Adjustment Tool