promo-director

プロモーションディレクタースキル

マスタリング済みの音源から、SNS 向けのプロモーション動画を作成します。Instagram Reels、Twitter、TikTok 向けに最適化された、縦型の15秒動画（9:16、1080x1920）を生成します。

目的

音源のマスタリング後、次の要素を組み合わせたプロモーション動画を作成します。

• アルバムアートワーク
• オーディオ波形のビジュアライゼーション（9種類のスタイルを利用可能）
• トラックタイトル＋アーティスト名
• アートワークから自動抽出した配色
• インテリジェントなセグメント選択（最もエネルギッシュな15秒を検出）

使用するタイミング

• マスタリング完了後、リリース前
• ユーザーが「プロモーション動画を生成して」または「[アルバム]のプロモーション動画を作成して」と言った場合
• アルバムのマスタリング済み音源とアートワークが用意できている場合

ワークフロー内での位置

Generate → Master → **[Promo Videos]** → Release

mastering-engineer と release-director の間の任意のステップです。

ワークフロー

1. セットアップの確認

ffmpeg を確認：

ffmpeg -filters | grep showwaves

必須フィルター：showwaves、showfreqs、drawtext、gblur

不足している場合：

Error: ffmpeg not found or missing required filters

Install ffmpeg:
  macOS: brew install ffmpeg
  Linux: apt install ffmpeg

After installing, run this command again.

Python の依存関係を確認：

get_python_command() を呼び出して、仮想環境が存在することを確認します。venv_exists が false の場合は、警告を表示して /bitwize-music:setup を提案します。

2. アルバムの検出

MCP 経由で音源のパスを解決：

resolve_path("audio", album_slug) を呼び出します。アーティストフォルダーを含む音源ディレクトリの完全なパスが返されます。

実行結果の例：~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/

内容を確認：

• ✓ マスタリング済みの音源ファイル（.wav、.mp3、.flac、.m4a）
• ✓ アルバムアートワーク（album.png または album.jpg）

アートワークが見つからない場合：

Error: No album artwork found in {audio_root}/artists/{artist}/albums/{genre}/{album}/

Expected: album.png or album.jpg

Options:
  1. Use /bitwize-music:import-art to place artwork
  2. Specify path manually: --artwork /path/to/art.png

Which option?

3. ユーザーの設定

まず設定ファイルのデフォルト値を確認：

~/.bitwize-music/config.yaml の promotion セクションからデフォルト値を読み取ります。

• promotion.default_style - デフォルトのビジュアライゼーションスタイル
• promotion.duration - デフォルトのクリップの長さ
• promotion.include_sampler - デフォルトでアルバムサンプラーを生成するかどうか
• promotion.sampler_clip_duration - サンプラー内の各トラックの秒数

設定セクションが存在しない場合は、組み込みのデフォルト値（pulse、15秒、サンプラー有効、各クリップ12秒）を使用します。

生成する内容を確認：

選択肢（デフォルトは設定値、または「両方」）：

1. トラックごとのプロモーション動画（各15秒）＋アルバムサンプラー（全トラック）
2. トラックごとのプロモーション動画のみ
3. アルバムサンプラーのみ

ビジュアライゼーションスタイルを確認：

デフォルトは promotion.default_style の値、未設定の場合は pulse です。

スタイル	おすすめのジャンル	説明
pulse	エレクトロニック、ヒップホップ	強いグロー効果を備えたオシロスコープ／心電図スタイル（デフォルト）
bars	ポップ、ロック	音に素早く反応するスペクトラムバー
line	アコースティック、フォーク	クラシックですっきりした波形
mirror	アンビエント、チル	左右対称の波形
mountains	EDM、ベース重視の音楽	デュアルチャンネルスペクトラム（山のような見た目）
colorwave	インディー、オルタナティブ	控えめなグロー効果の、すっきりした波形
neon	シンセウェーブ、80年代	鮮明な波形と力強いネオングロー
dual	実験的な音楽	異なる色（メインカラーと補色）で表示する2つの波形
circular	抽象的、実験的	ベクトルスコープ（自由な円形パターン）

デフォルトのおすすめ：

• エレクトロニック／ヒップホップ → pulse
• ロック／ポップ → bars
• フォーク／アコースティック → line
• アンビエント／チル → mirror

カスタムの長さを確認：

デフォルト：15秒（Instagram／Twitter に最適）

選択肢：

• 15秒（おすすめ、Instagram Reels に最適）
• 30秒（長めのプレビュー）
• 60秒（フルクリップ、あまり一般的ではありません）

サンプラーの場合：

デフォルト：トラックごとに12秒

合計時間を計算：

Total duration = (tracks * clip_duration) - ((tracks - 1) * crossfade)
Twitter limit: 140 seconds

140秒を超える場合：

WARNING: Expected duration {duration}s exceeds Twitter limit (140s)

Recommendation: Reduce --clip-duration to {140 / tracks}s

4. 生成

トラックごとのプロモーション動画：

generate_promo_videos(album_slug, style="pulse", duration=15)

トラックが1曲のみの場合：

generate_promo_videos(album_slug, style="pulse", track_filename="01-track-name.wav")

アルバムサンプラー：

generate_album_sampler(album_slug, clip_duration=12, crossfade=0.5)

エラーへの対応：

よくある問題：

• ffmpeg のフィルターエラー → ffmpeg のインストールにフィルターが含まれていることを確認します
• フォントが見つからない → dejavu フォントをインストールするか、カスタムフォントを指定します
• アートワークの抽出に失敗 → デフォルトのシアン配色を使用します
• librosa を利用できない → セグメントの選択位置をトラックの20%地点に切り替えます
• 音源ファイルが破損している → 該当トラックをスキップして報告し、残りのトラックの処理を続けます

5. 結果の概要

生成されたファイルを報告：

## Promo Videos Generated

**Location:** {audio_root}/artists/{artist}/albums/{genre}/{album}/

**Individual Track Promos:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/promo_videos/
- 10 videos generated
- Format: 1080x1920 (9:16), H.264, 15s each
- Style: pulse
- File size: ~10-12 MB per video

**Album Sampler:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/album_sampler.mp4
- Duration: 114.5s (under Twitter 140s limit ✓)
- Format: 1080x1920 (9:16), H.264
- File size: 45.2 MB

**Next Steps:**
1. Review videos: Open promo_videos/ folder
2. Test on phone: Transfer one video and verify quality
3. Populate social copy: Fill in promo/ templates (twitter.md, instagram.md, etc.)
4. [Optional] Upload to cloud: /bitwize-music:cloud-uploader {album}
5. Ready for release workflow: /bitwize-music:release-director {album}

技術リファレンス

以下については、technical-reference.md を参照してください。

• 出力仕様（解像度、フォーマット、ビットレート）
• 可視化スタイル（パルス、バー、線など）
• プラットフォームの互換性（Instagram、Twitter、TikTok）
• 依存関係（必須および任意）
• よくある問題のトラブルシューティング