ToonKit Shorts: ルックのカスタマイズ
すべてのスタイルは1つのファイル toonkit/look.yaml に集約されています（フォールバック先は looks/mort-and-blitz.yaml）。TOONKIT_LOOK=/path/x.yaml で上書き可能です。プリセット: toonkit/looks/{mort-and-blitz,clean-tech,retro}.yaml。
- プリセットの切り替え:
cp toonkit/looks/retro.yaml toonkit/look.yaml、またはextends: retroと変更したいキーのみを記述した look.yaml を作成。 - 音声を変更したら
./setup.shを実行（新しい Piper 音声をダウンロード）。bin/toonkit lookで確認。 - 変更を反映するには再レンダリング。キャッシュされた音声はエピソード ID ごとに再利用されます。音声変更後は
bin/toonkit clean <script> --stage audioを実行。
| キー | 説明 |
|---|---|
show_name | タイトルカードとサムネイルに表示されるタグ、説明文の {show} |
hosts.a / hosts.b .name | ホスト名。スクリプト内で speaker（または A/B）として使用可能 |
.personality | 日次実行スキルがそのホストの台詞をどのように書くか（a = 誇張、b = 無表情のオチが最も効果的） |
.voice | Piper 音声 ID（例: en_US-ryan-medium、en_GB-alan-medium）（一覧: https://huggingface.co/rhasspy/piper-voices） |
.tts_style | hype（より速く、迫力のある）または flat |
.caption_color | #RRGGBB 形式で、そのホストのアクティブな字幕単語をハイライトする色 |
.art / .lock | 有料の Imagine モード（--mode hybrid/rig）で新しいショットを描画するために使用される参照アートとその説明 |
palette.tints | タイトルカード／サムネイルに許可される色のバリエーション: toxic electric hotpink purple acid blood cyan sunset |
font.file / font.name | 字幕とタイトルカード用の TTF（name は字幕用フォントのファミリー名） |
captions | size、y（0 ～ 1920。Shorts UI の上部に表示されるように 1500 未満に設定）、基本 color、outline、1チャンクあたりの max_chars |
title_card | enabled、コールドオープンカードの seconds、show_tag（show_name バッジ） |
thumbnail | enabled、tint: auto または固定の色名 |
episode | length_s、niche（日次実行が調査するトピック）、lines、music `{bpm, riff: chug |
upload | privacy（デフォルト: private）、category ID、tags、playlist、made_for_kids、synthetic_media（true のままに）、description テンプレート（{show} {niche} {title} {source}） |
キャラクター / アート
無料モード（$0）では、バンドルされたアートライブラリをアニメーション化します（2つのキャラクター枠: ホスト a = 「誇張タイプ」、ホスト b = 無表情の女性、さらにセットとリアクションショット）。名前の変更、音声変更、色変更はそのアートに即座に反映されます。新しいキャラクターアートは新しいショットを意味します。hosts.*.art に参照 PNG を配置し、hosts.*.lock + art_style で説明を記述し、--mode rig（〜$0.6/エピソード、xAI Imagine、XAI_API_KEY が必要）または --mode hybrid（〜$1.7）でレンダリングします。費用が発生する前にユーザーに確認してください。