vox-radio

module

v0.0.9 Latest Latest Go to latest Published: Jun 5, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/canpok1/vox-radio

Links

Open Source Insights

README ¶

vox-radio

開発環境のセットアップ

前提

Docker / Dev Containers が使える環境

手順

.devcontainer/.env-template をコピーして .devcontainer/.env を作成する
```
cp .devcontainer/.env-template .devcontainer/.env
```
.devcontainer/.env に各自の値を設定する

変数名説明

GH_TOKEN GitHub Personal Access Token

GEMINI_API_KEY Gemini API キー（Google AI Studio で取得）
devcontainer をリビルドして起動する

注意: .devcontainer/.env には秘密情報が含まれるため、コミットしないこと（.gitignore で除外済み）。

リリース設定の検証

.goreleaser.yaml を編集した後は、CI を待たずにローカルで構文・設定を検証できます。

make release-check

goreleaser check を実行し、設定の構文エラーや不整合を検出します。goreleaser は devcontainer 起動時または make setup 実行時に自動インストールされます。

CLIの使い方

バイナリインストール（リリース版）

GitHub Releases のバイナリを curl のワンライナーで導入できます。

# 最新版をインストール
curl -fsSL https://raw.githubusercontent.com/canpok1/vox-radio/main/scripts/install-vox-radio.sh | bash

# バージョンを指定してインストール（引数で渡す）
curl -fsSL https://raw.githubusercontent.com/canpok1/vox-radio/main/scripts/install-vox-radio.sh | bash -s -- v0.0.1

# 設置先を変更（環境変数）
curl -fsSL https://raw.githubusercontent.com/canpok1/vox-radio/main/scripts/install-vox-radio.sh | INSTALL_DIR=$HOME/.local/bin bash -s -- v0.0.1

デフォルトの設置先は /usr/local/bin です。書き込み権限がない場合は自動で sudo にフォールバックします。

ビルド

make build

バージョンを埋め込む場合は VERSION を指定します。

make build VERSION=v0.1.0

ビルドしたバイナリのバージョンを確認するには --version フラグを使います。

vox-radio --version

動作確認用サンプル実行

examples/tech.yaml を使ってパイプライン全体を試すには make run-sample を実行します。

make run-sample

出力先は output/<YYYYMMDDHHMMSS>/ ディレクトリになります（例: output/20260601053357/episode.mp3）。

プロファイルや出力先を変更する場合は PROFILE / OUT_DIR 変数で上書きできます。

# 別のプロファイルを使う
make run-sample PROFILE=examples/other.yaml

# 出力先を指定する
make run-sample OUT_DIR=output/test

前提条件: GEMINI_API_KEY 環境変数と VOICEVOX Engine が必要です。

パイプライン概要

vox-radio は以下のパイプラインでポッドキャストを自動生成します。

collect → rundown → script → synth → assemble → manifest

コマンド	概要
`init`	カレントディレクトリに `vox-radio.yaml`・`episode-spec.yaml`・`feed-spec.yaml` のテンプレートを生成する（初回セットアップ用）
`episodegen`	collect → rundown → script → synth → assemble → manifest の全パイプラインを一括実行し 1 本のエピソードを生成する
`episodegen collect`	`corners[].source` に定義したフィード・URL からコーナーごとに記事を収集し `01_articles.json` を生成する
`episodegen rundown`	LLM が収集記事を選別し、コーナーごとの話の流れと要約を含む `02_rundown.json` を生成する（番組設計図）
`episodegen script`	rundown を LLM に渡して台本 `04_script.json` を生成する（write → direct の多段パイプライン）
`episodegen synth`	`04_script.json` をもとに VOICEVOX で音声クリップを合成する
`episodegen assemble`	音声クリップとイントロ・アウトロを ffmpeg で結合し MP3 エピソードを生成する
`episodegen manifest`	番組内容（タイトル・概要・要約・コーナー・コーナー会話要約・記事・会話メモ）を記した `manifest.json` を MP3 と並べて出力する。コーナー記事は `02_rundown.json`（選別済み）から取得する。`--lines` で番組全体要約・会話メモ（`conversation_notes`）・コーナー単位の会話要約を LLM で生成して付加する（`03_lines.json`（元表記）を入力とするため manifest の文字列は英字・漢字のまま出力される）
`feedgen`	キャッシュ（`.jsonl`）と `feed-spec.yaml` から RSS 2.0 + iTunes フィード（`feed.xml`）を生成する。manifest・mp3 は不要。エピソード状態は cache を正とする
`feedgen check`	`feed-spec.yaml` を strict モードでパースし、必須フィールド・URL/email 形式・プレースホルダを検証する。意味検証エラーは全件まとめて報告する
`slackpost`	`manifest.json` と `slack-spec.yaml` を入力に、mp3 を Slack へアップロードして配信する（Slack 配信版）。親メッセージ（mp3 + 初期コメント）とスレッド返信（要約 + コーナー）の 2 段構成
`slackpost check`	`slack-spec.yaml` を strict モードでパースし、必須フィールド（`slack.channel`）を検証する
`config check`	共通設定ファイルを strict モードでパースし、未知キー（typo）や設定値の不整合をエラーとして報告する（パスは `--config` で指定、省略時は `vox-radio.yaml`）
`episodegen check`	エピソード仕様 YAML を strict モードでパースし、アセット参照・キャラ参照の整合性を検証する（共通設定は `--config` で指定、省略時は `vox-radio.yaml`）
`assets check`	アセット設定 YAML（`assets.yaml`）を strict モードでパースし、typo・参照ファイル欠落・不正値（volume/fade/duck_ratio）をエラーとして報告する
`assets preview`	素材IDを指定し、パラメータを適用したプレビュー音声を MP3 で生成する（`--id {type}:{key} --out out.mp3 [--max-length-sec 秒]`）。loudnorm/alimiter は適用されない

設定ファイルの作成

vox-radio init を実行すると、カレントディレクトリに vox-radio.yaml（共通設定）・episode-spec.yaml（エピソード仕様）・feed-spec.yaml（フィード生成設定）・slack-spec.yaml（Slack 投稿設定）のテンプレートが生成されます。

# テンプレートを生成
vox-radio init

# 生成されたファイルを編集（LLM APIキー・番組設定を記入）
# その後、パイプラインを実行
vox-radio episodegen --spec episode-spec.yaml

既存ファイルは上書きされません（ファイルごとに独立してスキップ判定します）。

設定ファイル

設定は2種類に分かれています。

種別	ファイル	内容
共通設定 (config)	`vox-radio.yaml`（デフォルト。`--config` フラグで別パス指定可）	LLM / VOICEVOX URL / キャラカタログ
エピソード仕様 (spec)	`episode-spec.yaml` または `examples/<genre>.yaml`	program / corners（各コーナーの source でデータソース指定） / assets

vox-radio.yaml はデフォルトでカレントディレクトリから読み込まれます。別ディレクトリの設定ファイルを使う場合は --config フラグでパスを指定します。

# カレントディレクトリの vox-radio.yaml を使う（デフォルト）
vox-radio episodegen --spec episode-spec.yaml

# 別パスの設定ファイルを指定する
vox-radio --config /path/to/my-station/vox-radio.yaml episodegen --spec episode-spec.yaml

キャラカタログとスタイル選択

vox-radio.yaml の characters セクションには、キャラIDごとに複数の音声スタイルを定義できます。default_style は style 未指定時のフォールバックスタイルです。

characters:
  zundamon:
    name: ずんだもん
    pronoun: ボク
    speech_suffix: ["〜のだ", "〜なのだ"]
    personality: ["元気", "明るい"]
    default_style: ノーマル
    styles:
      ノーマル: 3    # style名 → VOICEVOX speaker_id
      あまあま: 1
      なみだめ: 76

台本生成（script コマンド）では、LLM がセリフの感情に応じてスタイルを選択します。synth コマンドは行ごとの style フィールドを読み取り、指定されたスタイルの speaker_id で合成します。style が未指定または不正な場合は default_style にフォールバックします。

エピソード仕様のサンプルは examples/ ディレクトリに用意しています。examples/tech.yaml（技術ニュース用）を、共通アセット（examples/assets/）とあわせて配置しています。これらをコピー・編集して利用してください。詳細は examples/README.md を参照してください。

実行例

# 記事を収集（--spec は必須）
vox-radio episodegen collect --out work/intermediate/01_articles.json --spec examples/tech.yaml

# 番組設計図（rundown）を生成
vox-radio episodegen rundown --in work/intermediate/01_articles.json --out work/intermediate/02_rundown.json \
    --spec examples/tech.yaml

# 台本を生成
vox-radio episodegen script --in work/intermediate/02_rundown.json --out work/intermediate/04_script.json \
    --spec examples/tech.yaml

# 音声合成（設定不要）
vox-radio episodegen synth --in work/intermediate/04_script.json --out-dir work/clips

# 音声結合
vox-radio episodegen assemble --in work/intermediate/04_script.json --clips work/clips --out work/episode.mp3 \
    --spec examples/tech.yaml

詳細リファレンス

各コマンドのフラグ一覧は自動生成ドキュメントを参照してください。

docs/cli/vox-radio.md — コマンド一覧
各サブコマンドの詳細: vox-radio <command> --help

設定ファイルリファレンス

vox-radio.yaml（共通設定）

vox-radio.yaml はデフォルトでカレントディレクトリから読み込まれます。--config フラグで別パスを指定できます。フィールド定義は internal/config/config.go の構造体が正です。

`llm` セクション

フィールド	型	必須/任意	説明
`provider`	string	任意	LLM プロバイダ。`openai`（デフォルト）または `dify-chat`
`temperature`	float64	任意	生成のランダム性（0.0〜1.0）。デフォルト: 0（Go ゼロ値）
`max_retries`	int	任意	APIリトライ回数。デフォルト: 0（Go ゼロ値）
`min_request_interval_ms`	*int	任意	リクエスト間隔（ミリ秒）。省略時は 4500ms
`steps`	map[string]LLMStepConfig	任意	ステップごとの設定（キー: ステップ名）
`openai`	OpenAIConfig	`provider: openai` 時必須	OpenAI 互換プロバイダの接続設定
`dify-chat`	DifyChatConfig	`provider: dify-chat` 時必須	Dify chat-messages の接続設定

llm.openai サブフィールド（provider: openai 時）

フィールド	型	必須/任意	説明
`base_url`	string	必須	LLM API のベースURL（OpenAI 互換エンドポイント）
`api_key_env`	string	必須	APIキーを格納する環境変数名
`model`	string	必須	使用するモデル名

llm.dify-chat サブフィールド（provider: dify-chat 時）

フィールド	型	必須/任意	説明
`base_url`	string	必須	Dify API サーバーURL（例: `https://api.dify.ai/v1`）
`api_key_env`	string	必須	Dify API キーを格納する環境変数名
`user`	string	任意	利用者識別子。省略時は `vox-radio`
`inputs`	map[string]string	任意	Dify アプリに渡す変数。値に `${temperature}` プレースホルダーを書ける

inputs の ${temperature} プレースホルダーについて:

値が "${temperature}" だけの場合（完全一致）→ そのステップの temperature を JSON 数値で送信
値に ${temperature} が含まれる場合（部分一致）→ 文字列として補間
プレースホルダーを書かない場合 → temperature を inputs に含めない

注意: inputs に temperature を載せても、Dify アプリ側でその変数をモデルパラメータにバインドしない限り効果はありません。

llm.steps.<step> サブフィールド

フィールド	型	必須/任意	説明
`temperature`	*float64	任意	このステップの温度（省略時は `llm.temperature` を使用）

組み込みステップ名: summarize（記事要約）、plan（台本設計）、write（セリフ執筆）、direct（ダイレクト生成）。

`voicevox` セクション

フィールド	型	必須/任意	説明
`url`	string	必須	VOICEVOX Engine のURL
`presets`	*VoicevoxPresets	任意	抑揚・音高・話速プリセット定義。省略時はコード組込みのデフォルトプリセットが適用される

voicevox.presets サブフィールド

フィールド	型	必須/任意	説明
`intonation`	map[string]float64	任意	抑揚プリセット（intonationScale, 0.0〜2.0）。省略時はデフォルト7段階が適用される
`pitch`	map[string]float64	任意	音高プリセット（pitchScale, -0.15〜0.15）。省略時はデフォルト7段階が適用される
`speed`	map[string]float64	任意	話速プリセット（speedScale, 0.5〜2.0）。省略時はデフォルト7段階が適用される

`cache` セクション

フィールド	型	必須/任意	説明
`enabled`	bool	任意	キャッシュ機能の有効/無効。デフォルト: false。`program.id` 未設定時は常に無効
`max_entries`	int	任意	JSONL に保持する最大エピソード数（超過分は古い行から削除）。デフォルト: 100
`retention_days`	int	任意	保持日数（超過した古い行は削除）。デフォルト: 90
`llm_context_entries`	int	任意	LLM へ渡す直近エピソード件数。デフォルト: 10

`characters` セクション

characters はキャラID（文字列キー）をキーにしたマップです。プロファイルの corners[].cast で使用するIDを定義します。

フィールド	型	必須/任意	説明
`name`	string	必須	キャラクターの表示名
`pronoun`	string	任意	一人称代名詞（台本生成時に LLM へ渡す）
`speech_suffix`	[]string	任意	語尾パターン（台本生成時に LLM へ渡す）
`personality`	[]string	任意	性格特徴（台本生成時に LLM へ渡す）
`default_style`	string	任意	デフォルトの音声スタイル名（`styles` のキーと一致させること）
`styles`	map[string]int	任意	スタイル名 → VOICEVOX 話者ID のマップ

default_style を指定した場合、その値は styles のキーとして存在しなければなりません（起動時検証あり）。

episode-spec.yaml（エピソード仕様）

--spec フラグで指定するジャンル別設定ファイルです。vox-radio init で生成されるテンプレートは episode-spec.yaml という名前です。詳細は examples/README.md も参照してください。

`program` セクション

フィールド	型	必須/任意	説明
`title`	string	任意	番組タイトル
`description`	string	任意	番組の説明（LLM への指示に使用）
`summary_length`	int	任意	番組全体サマリーの目安文字数。未指定時はデフォルト 200 文字

`corners` セクション

corners はコーナー定義のリストです。番組を構成するセグメントを順番に記述します。

フィールド	型	必須/任意	説明
`title`	string	必須	コーナータイトル
`content`	string	任意	コーナーの内容説明（台本生成 LLM への指示に使用）
`direction`	string	任意	コーナーの演出説明（演出生成 LLM への指示に使用。SE の挿入タイミングなど）。台本生成 LLM へは渡されない
`cast`	map[string]string	任意	キャラID → 役割説明のマップ（キーは `vox-radio.yaml` の `characters` のキーと一致させること）
`length_sec`	int	任意	このコーナーの目標収録時間（秒）。台本生成時に文字数（≈7文字/秒）へ換算される
`summary_length`	int	任意	コーナーサマリーの目安文字数。未指定時はデフォルト 100 文字
`source`	SourceConfig	任意	データソース（省略するとこのコーナーの収集はスキップ）
`start_audio`	AudioRef	任意	コーナー開始境界音声。`type` に `jingle`（BGM停止後再生）または `se`（BGMの下で再生）を指定し、`id` に `assets` の該当マップのキーを指定する。コーナー本編の前に確定的に挿入される
`end_audio`	AudioRef	任意	コーナー終了境界音声。`type`/`id` は `start_audio` と同様。コーナー本編の後に確定的に挿入される
`bgm`	string	任意	コーナー中 BGM のキー名（`assets.bgm` のキーと一致させること）。コーナー本編を開始/停止セグメントで挟む
`start_pause_sec`	float64	任意	コーナー先頭（`start_audio` より前）に挿入する無音時間（秒）。0 または省略時は挿入しない
`end_pause_sec`	float64	任意	コーナー末尾（`end_audio` より後）に挿入する無音時間（秒）。0 または省略時は挿入しない
`condition`	EpisodeCondition	任意	コーナーの出現条件（省略すると毎回必ず出る固定コーナー）

corners[].condition サブフィールド

condition を設定すると、回番号が条件に合致したときのみそのコーナーが採用されます。condition を省略したコーナーは毎回必ず採用される固定コーナーとなります。

corners:
  - title: "オープニング"       # condition なし → 毎回必須
    content: "挨拶と自己紹介"
    cast: { zundamon: "MC" }
    length_sec: 30

  - title: "月いちスペシャル"
    content: "5回に1回だけやるスペシャル企画"
    cast: { zundamon: "MC", metan: "MC" }
    length_sec: 120
    condition:
      every: 5                  # 5の倍数回（5,10,15,…）に採用

  - title: "通常トーク"
    content: "月いちスペシャルを行わない回の通常コーナー"
    cast: { zundamon: "MC", metan: "MC" }
    length_sec: 120
    condition:
      not:
        every: 5               # 5の倍数でない回（1,2,3,4,6,…）に採用

  - title: "今週の一冊"
    content: "おすすめの本を紹介"
    cast: { zundamon: "ボケ", metan: "解説" }
    length_sec: 120
    condition:
      every: 2                  # 偶数回に採用
      not:
        episodes: [6]           # ただし第6回は除く（2,4,8,10,…）

  - title: "エンディング"        # condition なし → 毎回必須
    content: "締めの挨拶"
    cast: { zundamon: "MC" }
    length_sec: 30

フィールド	型	必須/任意	説明
`condition.episodes`	[]int	任意	採用する回番号の明示リスト（各値は 1 以上）
`condition.every`	int	任意	周期的な採用（N の倍数回に採用。1 以上）
`condition.offset`	int	任意	`every` と組み合わせる剰余（`episodeNumber % every == offset` で採用。未指定=0 で倍数回）
`condition.not`	EpisodeCondition	任意	この条件に合致する回を除外（補集合）

condition.episodes と condition.every の両方を指定した場合は 論理和（どちらかに合致すれば採用）
condition.not に合致する回は除外される。not 単独指定（episodes/every を省略）すると「合致しない回すべて」を表現できる
肯定条件（episodes/every）を省略すると「常に真」として扱われ、not 単独で補集合を表現できる
condition.episodes・condition.every・condition.not のいずれも未設定の場合、および not の中身が空の場合はバリデーションエラー
キャッシュが無効または program.id が未設定で回番号が不明な場合、条件付きコーナーを含む全コーナーが採用されます（警告ログが出力されます）
採用されたコーナーは元の corners 配列の順序を維持したまま台本に出力されます

N者ローテーションの例（every + offset）

corners:
  - title: "コーナーA"
    condition: { every: 3, offset: 1 }   # 1,4,7,… 回に採用
  - title: "コーナーB"
    condition: { every: 3, offset: 2 }   # 2,5,8,… 回に採用
  - title: "コーナーC"
    condition: { every: 3, offset: 0 }   # 3,6,9,… 回に採用

corners[].source サブフィールド

フィールド	型	必須/任意	説明
`feeds`	[]FeedEntry	任意	RSS/Atom フィードのリスト
`articles`	[]string	任意	個別記事 URL のリスト

corners[].source.feeds[] サブフィールド

フィールド	型	必須/任意	説明
`url`	string	必須	フィードの URL
`max_items`	int	任意	過去使用URLを除外したうえで確保する最大記事数。デフォルト: 0（実質無制限）。除外で減った分はフィード内の後続記事で補う。

`guests` セクション（省略可）

guests はゲスト出演者の設定をキャラID（vox-radio.yaml の characters のキー）をキーとするマップで定義します。指定した条件に合致した回だけゲストが出演し、その回はオープニングからエンディングまで全コーナーにゲストが通しで出演します。

guests:
  zunko:                             # キー = characters に定義済みのキャラID
    role: 古参リスナー出身の常連ゲスト  # 全コーナーの cast にマージされる役割説明
    condition:
      episodes: [3, 10, 20]          # 第3回・第10回・第20回に登場（明示リスト）
  metan:
    role: 業界に詳しい解説ゲスト
    condition:
      every: 5                       # 5, 10, 15, … の回に登場（定期出演）
  sora:
    role: フリーランスエンジニア
    condition:
      not:
        every: 5                     # 5の倍数以外の回に登場（metan がいない回すべて）

フィールド	型	必須/任意	説明
`role`	string	任意	全コーナーの cast にマージされるゲストの役割説明
`condition.episodes`	[]int	任意	出演する回番号の明示リスト（各値は 1 以上）
`condition.every`	int	任意	周期的な出演（N の倍数回に出演。1 以上）
`condition.offset`	int	任意	`every` と組み合わせる剰余（`episodeNumber % every == offset` で出演。未指定=0 で倍数回）
`condition.not`	EpisodeCondition	任意	この条件に合致する回を除外（補集合）

condition.episodes と condition.every の両方を指定した場合は 論理和（どちらかに合致すれば出演）
condition.not に合致する回は除外される。not 単独指定（episodes/every を省略）すると「合致しない回すべて」を表現できる
肯定条件（episodes/every）を省略すると「常に真」として扱われ、not 単独で補集合を表現できる
condition.episodes・condition.every・condition.not のいずれも未設定の場合はバリデーションエラー
キャッシュが無効または program.id が未設定で回番号が不明な場合、ゲストは出演しません（警告ログが出力されます）

N者ローテーションの例（every + offset）

guests:
  alice:
    role: ゲストA
    condition: { every: 3, offset: 1 }   # 1,4,7,… 回に出演
  bob:
    role: ゲストB
    condition: { every: 3, offset: 2 }   # 2,5,8,… 回に出演
  carol:
    role: ゲストC
    condition: { every: 3, offset: 0 }   # 3,6,9,… 回に出演

`assets_files` フィールド

assets_files はアセット設定ファイル（ジングル・SE・BGM を定義した YAML）のパスリストです。バイナリ素材は別途用意してください。

assets_files の各パスはプロファイルファイルのディレクトリを基準に解決されます
アセット設定ファイル内の file: 相対パスはそのアセット設定ファイルのディレクトリを基準に解決されます（アセット設定ファイルと音声素材をひとまとめに配布できます）
複数ファイルを指定した場合は後勝ちでマージされます（共通アセット集＋番組固有アセットの組み合わせが可能）
assets_files を省略した場合はアセットが空となります（アセット不要なプロファイルで許容）

# プロファイルファイルからの参照
assets_files:
  - assets/assets.yaml          # 共通アセット集
  - assets/my-assets.yaml       # 番組固有アセット（後勝ちでマージ）

アセット設定ファイルのトップレベルには jingle: / se: / bgm: を記述します。

音声アセットは script.json のセグメント型として統一的に表現されます。各セグメントは type フィールドで種別を指定し、asset_name フィールドで対応するマップのキーを参照します。

セグメント種別	`type` 値	再生方式	説明
音声（ナレーション）	`speech`	serial	メイン音声。複数同時不可
効果音	`se`	serial（既定）/ overlay（`overlay: true` 指定時）	既定は SE が鳴り終わってから次のセリフを再生（順次）。`overlay: true` を設定すると音声に重ねて再生
BGM	`bgm`	overlay	音声の裏で再生。排他（停止→切替）。`asset_name` 空 = 停止
ジングル	`jingle`	serial	単独再生（音声・BGMと重ならない）。前後に pause が入る

ジングルはラン境界として機能します: 台本がジングルで区切られ、各ラン内の SE/BGM はそのランにのみ適用されます（ジングルをまたいで継続しません）。

アセット設定ファイル: jingle マップ値

フィールド	型	必須/任意	説明
`file`	string	必須	音声ファイルパス
`fade_in`	float64	任意	フェードイン時間（秒）。デフォルト: 0
`fade_out`	float64	任意	フェードアウト時間（秒）。デフォルト: 0
`trim_silence`	bool	任意	前後の無音を自動除去するかどうか。デフォルト: true
`trim_silence_threshold`	float64	任意	無音判定の振幅閾値（dB、負値のみ）。デフォルト: -50。素材のノイズフロアに合わせて調整
`description`	string	任意	アセットの説明（「何の音か・いつ使うか」）。LLM が挿入タイミングを判断する際の手がかりになる

ジングルおよびコーナー境界 SE はコーナー毎に corners[].start_audio / corners[].end_audio（type: jingle または type: se）で設定します。script 生成ステップでコードがコーナー本編の前後へ確定的に挿入するため、生成された 04_script.json にジングル/SEセグメントが含まれます。type: jingle は BGM を停止してから再生し、type: se は BGM を継続したまま BGM の下で再生します。BGM も corners[].bgm で同様にコーナー単位で管理します。

アセット設定ファイル: se マップ値

フィールド	型	必須/任意	説明
`file`	string	必須	音声ファイルパス
`volume`	float64	任意	音量倍率。デフォルト: 0（Go ゼロ値）
`trim_silence`	bool	任意	前後の無音を自動除去するかどうか。デフォルト: true
`trim_silence_threshold`	float64	任意	無音判定の振幅閾値（dB、負値のみ）。デフォルト: -50。素材のノイズフロアに合わせて調整
`overlay`	bool	任意	`true` = 音声に重ねて再生（従来の overlay 動作）。`false` または省略 = SE が鳴り終わってから次のセリフを再生（順次）。デフォルト: false
`description`	string	任意	アセットの説明（「何の音か・いつ使うか」）。LLM が挿入タイミングを判断する際の手がかりになる

アセット設定ファイル: bgm マップ値

フィールド	型	必須/任意	説明
`file`	string	必須	音声ファイルパス
`volume`	float64	任意	音量倍率。デフォルト: 0（Go ゼロ値）
`duck_ratio`	float64	任意	セリフ再生中の音量低減比率（サイドチェインコンプ）。デフォルト: 0
`loop`	bool	任意	ループ再生するかどうか。デフォルト: false
`fade_in`	float64	任意	BGM 開始時のフェードイン秒数。省略時は 1.0 秒。`0` を指定するとフェードなし
`fade_out`	float64	任意	BGM 終了時のフェードアウト秒数。省略時は 1.0 秒。`0` を指定するとフェードなし
`description`	string	任意	アセットの説明（「何の音か・いつ使うか」）。LLM が挿入タイミングを判断する際の手がかりになる

BGM の開始・停止は台本の bgm セグメントで制御します。asset_name にキー名を指定するとその BGM を開始し、空文字列を指定すると停止します。

同一ラン内で BGM が別の BGM に切り替わる場合、前の BGM がフェードアウトしつつ次の BGM がフェードインするクロスフェードが自動で適用されます（重なり幅 = min(prevFadeOut, nextFadeIn)）。ジングル境界または BGM 明示停止時も fade_out 秒でフェードアウトします。

feed-spec.yaml（フィード生成設定）

feed-spec.yaml は vox-radio feedgen / vox-radio feedgen check が使用するフィード生成設定ファイルです。vox-radio init で生成されるテンプレートを元に編集してください。

フィールド	型	必須/任意	説明
`program_id`	string	必須	feedgen がキャッシュから対象エピソードを絞り込むキー。`episode-spec.yaml` の `program.id` と一致させること
`feed.language`	string	必須	言語コード（RSS channel language）。例: `ja`
`feed.author`	string	必須	配信者名（itunes:author）
`feed.email`	string	必須	連絡先メールアドレス（itunes:email）
`feed.site_url`	string	必須	番組サイト URL（RSS channel link）
`feed.audio_url_template`	string	必須	各エピソード音声ファイルの URL テンプレート。`{episode_number}` と `{audio_file}` が cache の値で置換される
`feed.category`	string	任意	iTunes カテゴリ。空文字でタグ省略
`feed.explicit`	bool	任意	露骨な表現の有無（itunes:explicit）。デフォルト: false
`feed.cover_image_url`	string	任意	カバー画像 URL（itunes:image）。空文字でタグ省略
`feed.credit`	string	任意	クレジット表記（各 item の itunes:author）。空文字で省略
`output.public`	string	任意	`feed.xml` を書き出すディレクトリ。デフォルト: `public`

必須フィールドの欠落・URL/email 形式・audio_url_template のプレースホルダ（{episode_number} / {audio_file}）は vox-radio feedgen check で検証されます。意味検証エラーは全件まとめて報告されます。

slack-spec.yaml（Slack 投稿設定）

slack-spec.yaml は vox-radio slackpost / vox-radio slackpost check が使用する Slack 投稿設定ファイルです。vox-radio init で生成されるテンプレートを元に編集してください。

必要な Slack スコープ

スコープ	用途
`chat:write`	スレッド返信の投稿
`files:write`	mp3 ファイルのアップロード

Bot トークンの設定

Bot トークン（xoxb-...）は共通設定 vox-radio.yaml の slack.bot_token_env で指定した環境変数名から読み込まれます。

# vox-radio.yaml
slack:
  bot_token_env: SLACK_BOT_TOKEN   # 環境変数名を指定

# 環境変数を設定してから実行
export SLACK_BOT_TOKEN=xoxb-your-token-here
vox-radio slackpost --manifest output/manifest.json --spec config/slack-spec.yaml

slack-spec.yaml フィールド一覧

フィールド	型	必須/任意	説明
`program_id`	string	任意	番組 ID（ログ・将来の突合用）
`slack.channel`	string	必須	投稿先チャンネル ID（`C` で始まる Slack のチャンネル ID）
`slack.message.header`	string	任意	親メッセージ（mp3 アップロード時の初期コメント）のテンプレート
`slack.message.fallback`	string	任意	スレッド返信の通知用プレーンテキストのテンプレート
`slack.message.summary`	string	任意	スレッド返信の要約 Section テンプレート（空のとき省略）
`slack.message.corner`	string	任意	コーナー Section テンプレート
`slack.message.article`	string	任意	記事 1 件のテンプレート

message.* を省略した場合はコード側のデフォルトテンプレートが適用されます。

利用可能なプレースホルダ

スコープ	プレースホルダ	manifest フィールド
全体（header/summary/fallback）	`{title}` `{episode_number}` `{episode_title}` `{description}` `{summary}` `{datetime}` `{audio_file}`	`Manifest` の各 json タグ
コーナー（`corner`）	`{corner_title}` `{corner_summary}` `{articles}`	`ManifestCorner.Title` / `.Summary` / 記事展開
記事（`article`）	`{title}` `{url}`	`ArticleRef.Title` / `.URL`

投稿フロー

vox-radio.yaml から Bot トークンを環境変数で取得
manifest.json を読み込み、mp3 パスを自動解決（manifest と同じディレクトリ + audio_file）
slack-spec.yaml を読み込み・検証
mp3 を Slack へアップロード（親メッセージ = mp3 + 初期コメント）
要約・コーナーをスレッドに返信（要約・コーナーが両方空の場合はスレッド投稿をスキップ）

Directories ¶

Path	Synopsis
cmd
vox-radio command
internal
assemble
cache
cast
cli
collect
config
feed
fileio
logging
manifest
mediainfo
model
pipeline
rundown
rundown/flow
rundown/select
script
script/direct
script/llm
script/summarize
script/summary
script/write
slack
synth
tools
gendocs command

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

変数名	説明
`GH_TOKEN`	GitHub Personal Access Token
`GEMINI_API_KEY`	Gemini API キー（Google AI Studio で取得）

README ¶

vox-radio

開発環境のセットアップ

前提

手順

リリース設定の検証

CLIの使い方

バイナリインストール（リリース版）

ビルド

動作確認用サンプル実行

パイプライン概要

設定ファイルの作成

設定ファイル

キャラカタログとスタイル選択

実行例

詳細リファレンス

設定ファイルリファレンス

vox-radio.yaml（共通設定）

llm セクション

voicevox セクション

cache セクション

characters セクション

episode-spec.yaml（エピソード仕様）

program セクション

corners セクション

guests セクション（省略可）

assets_files フィールド

feed-spec.yaml（フィード生成設定）

slack-spec.yaml（Slack 投稿設定）

必要な Slack スコープ

Bot トークンの設定

slack-spec.yaml フィールド一覧

利用可能なプレースホルダ

投稿フロー

Directories ¶

`llm` セクション

`voicevox` セクション

`cache` セクション

`characters` セクション

`program` セクション

`corners` セクション

`guests` セクション（省略可）

`assets_files` フィールド