メインコンテンツへスキップ
SubtitleMatrix

VTT を JSON に変換

形式変換WebVTT(VTT)
字幕テキストを貼り付けることもできます

この変換で変わること

1 項目が失われるか、判断が必要です

  • 形式固有の内容

    元の形式が字幕ブロックの外に保持している内容(字幕以外のブロック、ヘッダーのテキスト、字幕ごとの設定、コメントアウトされたイベント)。変換先の形式に置き場所がありません

この一覧は、読み込んだファイルではなく、この2つの形式の機能対応表から作られています。形式としては許されているが対応表が扱っていない機能を使っている場合、そのファイルではさらに多くが失われることがあります。

このページは WebVTT を JSON に変換します。ファイルをドロップするかテキストを貼り付けると、同じ字幕を記述した素の JSON 文書が返ります。変換はすべてブラウザ内で完結し、アップロードもアカウント登録も不要で、読み込み後はネットワークを切っても動きます。

JSON はこのサイト独自の字幕スキーマで、変換器全体が使う字幕モデルに合わせて意図的に形を決めています。バージョン番号のあとに字幕ごとの項目が続き、各項目は識別子、整数ミリ秒の開始と終了、テキストとインライン区間を持つ行の配列を持ちます。時刻はタイムコードに書き直されず整数ミリ秒のまま、行は結合されず別々のままなので、動画プレーヤーではなく自分のスクリプトが読むための出力です。

WebVTT が保存するほとんどはその形で表現できます。だから上のレポートは短いのです。JSON にキーがないのは字幕の外にあるもので、WEBVTT ヘッダーとそのコメント、NOTE、STYLE、REGION ブロック、align:start などの字幕ごとの設定です。それらは空いたフィールドに押し込まれず捨てられ、上のレポートはダウンロード前にあなたのファイルでその数を数えます。逆方向の例外は字幕の識別子で、SRT と違いこのスキーマには id フィールドがあるため intro は intro のまま残ります。

崩れた入力も問題ありません。ヘッダーの欠落、Windows の改行、タイムスタンプの前の余分な行、BOM はどれもそのまま読めます。1 ファイルでも 1 シーズン分でも、キューが順に処理し、途中で止められ、結果は 1 つの ZIP にまとまります。

例

典型的な VTT ファイルを JSON に変換した例

入力

WEBVTT

intro
00:00:01.000 --> 00:00:04.000
Hello there.

00:00:04.500 --> 00:00:08.000 align:start position:10%
Second line with <i>italics</i>.

出力

{
  "version": 1,
  "cues": [
    {
      "id": "intro",
      "start": 1000,
      "end": 4000,
      "lines": [
        "Hello there."
      ]
    },
    {
      "start": 4500,
      "end": 8000,
      "lines": [
        {
          "text": "Second line with italics.",
          "tags": [
            {
              "kind": "italic",
              "start": 17,
              "end": 24
            }
          ]
        }
      ]
    }
  ]
}

この出力で失われるもの:形式固有の内容。それ以外は行単位で一致します。

崩れた VTT 入力を JSON に変換した例

入力

a stray comment line
cue-id-1
00:00:01.000 --> 00:00:02.000
No header, two lines before the timecode.

出力

{
  "version": 1,
  "cues": [
    {
      "start": 1000,
      "end": 2000,
      "lines": [
        "No header, two lines before the timecode."
      ]
    }
  ]
}

実ファイルの傷み方の例です。改行の混在、余分な空白、空のフィールドが含まれます。上の整った例と比べると、パーサーがどこまで許容するかが分かります。

よくある質問

VTT を JSON に変換した出力はどんな形ですか?

バージョン番号と cues 配列です。各字幕は任意の id、整数ミリ秒の start と end、lines 配列を持ちます。各行は文字列か、text と、斜体・太字などを表す開始位置と終了位置の区間を持つオブジェクトです。解析すべきタイムコードも、気をつけるべき 100 分の 1 秒もありません。

VTT から JSON で失われる項目が少ないのはなぜですか?

スキーマが変換器の字幕モデルをすべて収められるように作られ、それが WebVTT のほぼすべてを覆うからです。残るのは WebVTT が字幕そのものの外に保存するもの、つまりヘッダー、そのコメント、NOTE、STYLE、REGION ブロック、字幕ごとの設定です。

VTT の字幕の識別子は JSON に残りますか?

残ります。WebVTT は字幕の前に intro や sign-1 のような自由な識別子を置け、このスキーマには id フィールドがあるためそのまま書き出されます。代わりに SRT へ変換すると、SRT の番号は数値でなければならないため振り直されます。

VTT から JSON でタイミングは変わりますか?

変わりません。どちらも整数ミリ秒で動くため、00:00:01.234 は 1234 になり、また戻っても丸めもずれもありません。

VTT の文字起こしを JSON に変換しても安全ですか?

安全です。解析と書き出しはブラウザ内で行われるため、ドロップしたファイルがサーバーに送られることはありません。JSON はスクリプトやパイプラインが消費する形式で、そうした文字起こしこそ建物の外に出せないことが多いため、この組ではとくに重要です。

関連ツール