Suno Visualizer Pro
AI Lyric Video & Visualizer Toolkit ご利用ガイド
はじめに：AIでリリックビデオ制作を加速する
この度は、AIリリックビデオ＆ビジュアライザー制作支援ツール「Suno Visualizer Pro」をご利用いただき、誠にありがとうございます。
このガイドでは、プロの開発現場で標準的に使われているバージョン管理システム「Git」と、そのプラットフォームである「GitHub」を導入し、今後のツールアップデートをコマンド一行で完了できる環境を構築します。一度設定すれば、制作の効率が飛躍的に向上しますので、ぜひこの機会に、プロのワークフローを体験してみましょう。
Git/GitHubを導入する3つのメリット
- アップデートが劇的に楽になる：ツール更新時、コマンド1行で瞬時に最新版にできます。Zip再ダウンロードや設定ファイル（APIキー等）の手動移行は不要になります。
- 安全な設定管理：あなたが編集したAPIキーなどの個人設定ファイルは、アップデートで上書きされない仕組みで保護されます。
- プロのスキルが身につく：Git/GitHubは現代のIT業界で必須のスキルです。この手順を通じて、その基本操作を自然と学べます。
1. PCへの導入手順（初回のみ）
外部ツール(FFmpeg)のインストール (必須)
動画クリップやビジュアライザーの生成に、動画・音声処理の定番ツール「FFmpeg」をインストールし、PCのどこからでも呼び出せるように設定（PATHを通す）する必要があります。
- FFmpeg公式サイトからお使いのOSに合ったものをダウンロードします。
- 詳しいインストールとPATH設定方法は、Webで「ffmpeg インストール (お使いのOS名)」などで検索してください。
GitHubからの招待を承認する
本ツールはアクセスが制限されたプライベートなリポジトリで提供されています。利用申請後、ご自身のGitHubアカウント宛に開発チームからの招待メールが届きますので、まず、この招待を承認してください。
- メールボックスを確認し、「[GitHub] okihiro-ai-creative has invited you to collaborate」という件名のメールを開きます。
- メール本文にある緑色の「View invitation」ボタンをクリックし、開いたページで招待を承認します。
Gitをインストールする
次に、ツールをPCにダウンロードしたり、最新版にアップデートするために必要なコマンドラインツール「Git」をインストールします。
ツールをダウンロード＆更新する
いよいよツール本体をPCにダウンロードします。コマンドプロンプト（Windows）またはターミナル（Mac）を開き、以下のコマンドを実行してください。
A. 初回ダウンロード (Clone)
PCの作業したいフォルダへ移動してから（例: cd Desktop）、以下のコマンドをコピーして実行します。Suno-Visualizer-Proというフォルダが作成され、ツールがダウンロードされます。
git clone git@github.com:okihiro-ai-creative/Suno-Visualizer-Pro.git
B. 今後のアップデート方法 (Pull)
今後ツールが更新された際は、ダウンロードしたSuno-Visualizer-Proフォルダ内で以下のコマンドを実行するだけで、常に最新版を利用できます。
git pull
2. ツールの使い方
ツールの初回セットアップ & APIキー設定
ダウンロードしたフォルダ内で、お使いのOSに合わせたセットアップスクリプトを一度だけ実行します。
- Windows:
_setup.batをダブルクリックします。 - macOS: ターミナルで
sh _setup.shを実行します。
完了後、systemフォルダにapi_keys_gemini.txtが生成されます。このファイルを開き、ご自身のGemini APIキーを貼り付けて保存してください。
入力ファイルの準備
ツールを使用する前に、input_dataフォルダに必要なファイルを配置します。
lyrics.srt: Suno AIなどからダウンロードした歌詞のSRTファイル。full_song_audio.wav: 楽曲全体の音声ファイル。images/: リリックビデオで使用する画像ファイルをこのフォルダに入れます。
ツールの起動と操作
お使いのOSに合わせて、_run_guiスクリプトを実行してGUIランチャーを起動します。
- Windows:
_run_gui.batをダブルクリックします。 - macOS: ターミナルで
sh _run_gui.shを実行します。
起動したGUIはタブ形式になっています。目的に合わせてタブを選択し、各機能をご利用ください。
AIプロンプト設計
歌詞とテーマを基に、Stable Diffusion用の画像プロンプトをAIが生成します。
リリックビデオ素材
歌詞に同期した動画クリップと分割音声を一括で生成し、動画編集の準備をします。
オーディオビジュアライザー
楽曲全体から、音楽に反応するフル尺のビジュアライザー動画を生成します。
ユーティリティ
画像の一括リネームやフォルダ振り分けなど、素材管理を効率化します。
3. 困ったときは (サポートについて)
- 導入や操作でエラーが出た場合は、まずこのガイドページをもう一度よくお読みください。多くの場合、手順の見落としやコマンドの入力ミスが原因です。
- それでも解決しない導入に関するトラブルに限り、LINE公式アカウントにてサポートを承ります。その際は、どのステップで問題が発生したか、エラーメッセージなどを添えてご連絡いただくと、スムーズな対応が可能です。