vhs-recording

VHS 録画スキル

VHS テープファイルからプロフェッショナルなターミナル録画を生成します。

使用する場合

• VHS テープスクリプトでターミナルセッションを録画する場合
• ドキュメント用のターミナルデモ録画を作成する場合

使用しない場合

• ブラウザーを使ったワークフローの場合。代わりに scry:browser-recording を使用してください
• ターミナル以外のデモや GUI アプリケーションの場合

概要

VHS は宣言型のテープファイルを、ターミナルセッションのアニメーション GIF に変換します。テープファイルでは、コマンド、タイミング、ターミナルの外観を定義します。

必須の進捗項目

- Locate and validate tape file
- Check VHS installation status
- Execute VHS recording
- Verify output GIF creation

モジュールリファレンス

• VHS テープファイルのディレクティブについては、modules/tape-syntax.md を参照してください
• 録画のワークフローの詳細については、modules/execution.md を参照してください

ワークフロー

フェーズ 1：テープファイルの検証

1. 指定されたパスにテープファイルが存在することを確認します
2. テープファイルの内容を読み込みます
3. 必須のディレクティブを確認します：
   • Output ディレクティブで GIF の保存先が指定されている
   • 少なくとも 1 つのアクションコマンド（Type、Enter など）がある

フェーズ 2：VHS のインストール確認

which vhs && vhs --version

インストールされていない場合：

# Linux/WSL
go install github.com/charmbracelet/vhs@latest

# macOS
brew install charmbracelet/tap/vhs

# Also requires ttyd and ffmpeg

フェーズ 3：録画の実行

vhs <tape-file.tape>

VHS は次の処理を行います：

1. テープファイルのディレクティブを解析します
2. 仮想ターミナル（ttyd）を起動します
3. タイミングに従ってコマンドを実行します
4. フレームをキャプチャします
5. ffmpeg を使用して GIF にエンコードします

フェーズ 4：出力の確認

1. Output パスに GIF ファイルが存在することを確認します
2. ファイルサイズが 0 ではないことを確認します
3. 出力先を示して成功を報告します

完了条件

• 指定された Output パスに GIF ファイルが作成されている
• 録画が正常に完了したことを示すファイルサイズになっている（通常は 50KB 超）
• VHS の実行中にエラーメッセージが出ていない

トラブルシューティング

よくある問題

vhs が見つからない場合は、Go の bin ディレクトリ（通常は ~/go/bin）が PATH に含まれていることを確認してください。録画を開始できない場合は、VHS がターミナルのエミュレーションと動画のエンコードに使用する ttyd と ffmpeg がインストールされていることを確認してください。GIF の書き込み時に「permission denied」エラーが発生する場合は、出力ディレクトリが存在し、書き込み可能であることを確認してください。