PitchTool

2025/07/04 初版公開
Created by Studio Mitsu

【背景 / Background】

音声ファイルの周波数（ピッチ）を解析・調整したい場面は多くあります。
本ツールは、音楽・音響・ヒーリング用途などで使用される .mp3 や .wav ファイルを対象に、
中心周波数の推定と、指定周波数へのピッチ変換を簡単に行うPythonスクリプトです。

【目的 / Purpose】

このツールは、以下の2つの機能を提供します：

• モード1：入力音声ファイルの中心周波数（Hz）を推定表示
• モード2：実測周波数をもとに、指定の目標Hzへピッチ変換（周波数スライド）

【環境 / Environment】

• Python 3.8以降
• 必須パッケージ：
  • librosa
  • numpy
  • pydub
  • soundfile

インストール例：

pip install librosa numpy pydub soundfile

※ .mp3 を扱う場合は ffmpeg がシステムにインストールされている必要があります。

【使い方 / Usage】

基本構文：

python pitch_tool.py --mode 1 --input yourfile.mp3

または

python pitch_tool.py --mode 2 --input yourfile.mp3 --output output.wav --pitch 432

引数一覧：

引数	必須	内容
--mode	✅	1 = 周波数解析 / 2 = ピッチ変換
--input	✅	入力ファイルパス（.mp3 または .wav）
--output	モード2のみ	出力ファイルパス（.wav）
--pitch	モード2のみ	目標周波数（Hz）。例：528、432 など

🎵 モード1：周波数解析

python pitch_tool.py --mode 1 --input sample.mp3

出力例：

[モード1] 周波数分析中: sample.mp3
🎵 中心周波数の推定値: 440.12 Hz

🎯 モード2：ピッチ変換

python pitch_tool.py --mode 2 --input sample.mp3 --output sample_432hz.wav --pitch 432

出力例：

[モード2] ピッチ変換準備中: sample.mp3
🎵 実測中心周波数: 440.12 Hz
🎯 目標周波数: 432.00 Hz
✅ ピッチ変換完了（440.12 Hz → 432.00 Hz）

【ディレクトリ構成 / Directory Structure】

PitchTool/
├── pitch_tool.py           # 本体スクリプト
├── README.md               # このファイル
├── LICENSE                 # ライセンス（任意）

【ライセンス / License】

MIT License │ 自由に使用・改変・再配布可能です

【著作権 / Copyright】

(c) 2025 Studio Mitsu

本ツールは音響・周波数調整用途を目的として提供されています。
治療目的や医学的効果は保証されません。

💡 このツールが役立ったと感じたら、
Buy Me a Coffee ☕ での応援もお待ちしています！