このプログラムのREADMEを作成してください。観点としては、1:ユーザーサイドの使用方法、2:このソースコードをクローンして使用するまでの手順としてください。

README: Audio Visualizer Script

概要

このプログラムは、MP3音声ファイルからオーディオビジュアライザー付きのMP4動画を生成するPythonスクリプトです。

音声の波形を視覚的に表示しながら動画化し、背景画像やフェードエフェクトの適用も可能です。

1. ユーザー向け使用方法

必要環境

インストール

以下のコマンドを実行し、必要なPythonライブラリをインストールしてください:

pip install numpy matplotlib librosa moviepy opencv-python pillow soundfile

実行方法

基本的な実行例:

python audio2mp4.py input.mp3

このコマンドは input.mp3 のビジュアライザー付き動画 audio.mp4 を作成します。

オプション

オプション 説明 デフォルト値
--output 出力MP4ファイル名 audio.mp4
--video-width 動画の幅 (px) 1280
--video-height 動画の高さ (px) 720
--viz-width ビジュアライザーの幅 (px) 1080
--viz-height ビジュアライザーの高さ (px) 520
--bg-color 背景色 (black, white など) black
--viz-color ビジュアライザーの色 (gradation で青→赤グラデーション) gradation
--loop-count 音声のループ回数 1
--bg-image 背景画像パス なし
--effect fade を指定するとフェードアウト効果 なし

実行例

  1. 赤色のビジュアライザーで出力:

    python audio2mp4.py input.mp3 --viz-color red