跳至主要內容
SubtitleMatrix

JSON 轉 CSV

或者貼上字幕文字

這次轉換會改變什麼

有 3 項會被捨棄或需要你決定

  • 樣式

    全部樣式(粗體、斜體、顏色、外框、陰影)

  • 定位

    螢幕定位(每條字幕都會回到預設位置)

  • 卡拉 OK

    卡拉 OK 計時(逐音節高亮)

這份清單來自這兩種格式的能力矩陣,而不是你載入的這份具體檔案。如果具體檔案用到了格式允許、但矩陣沒有建模的特性,可能會遺失更多。

這一頁把 JSON 字幕檔轉成 CSV。拖入檔案或直接貼上文字,就會拿回 CSV 版本;轉換全程在瀏覽器裡跑,不上傳、也不需要帳號。

兩個格式能存的東西不同,差別不是外觀問題:樣式、定位與卡拉OK在 CSV 裡沒有落點。上方清單來自兩個格式各自能表達什麼,不是讀了你的檔案才算出來的,所以檔案還沒載入就已經是這個答案。

本站的 JSON 完整形狀是版本號加一個 cues 陣列,也可以直接是一串 cue;它保留樣式、定位與卡拉OK,這些正是播放器格式常丟掉的。單檔可以,整季也可以:佇列依序處理,結果打包成一個 ZIP。

範例

一份典型的 JSON 檔轉成 CSV

輸入

{
  "version": 1,
  "title": "Fixture: typical",
  "fps": 25,
  "styles": {
    "Default": {
      "name": "Default",
      "fontFamily": "Arial",
      "fontSize": 20,
      "primaryColor": "#FFFFFF",
      "bold": false,
      "italic": false
    }
  },
  "generator": "subtitlematrix fixtures",
  "cues": [
    {
      "id": "1",
      "start": 0,
      "end": 2000,
      "lines": [
        "Hello world.",
        "Second line."
      ],
      "style": "Default",
      "position": {
        "x": 100,
        "y": 200,
        "align": "center"
      }
    },
    {
      "id": "2",
      "start": 2500,
      "end": 4000,
      "lines": [
        "Plain line.",
        {
          "text": "Styled line.",
          "tags": [
            {
              "kind": "italic",
              "start": 0,
              "end": 6
            }
          ]
        }
      ]
    },
    {
      "id": "3",
      "start": 4500,
      "end": 6000,
      "lines": [
        "Roger: I am here."
      ],
      "speaker": "Roger"
    }
  ]
}

輸出

start,end,text
00:00:00.000,00:00:02.000,"Hello world.
Second line."
00:00:02.500,00:00:04.000,"Plain line.
<i>Styled</i> line."
00:00:04.500,00:00:06.000,Roger: I am here.

這份產物丟掉了:樣式、定位與卡拉OK。其餘內容逐行對得上。

同一轉換遇到結構鬆散的 JSON 輸入

輸入

[
    { "start": 0, "end": 1000, "lines": ["First."] },
    { "start": 1000, "end": 2000, "text": "Second." },
    "not an object",
    { "start": 2000, "end": 3000, "lines": ["Third."], "class": "top" }
]

輸出

start,end,text
00:00:00.000,00:00:01.000,First.
00:00:01.000,00:00:02.000,Second.
00:00:02.000,00:00:03.000,Third.

真實檔案常有混合換行、多餘空白與空欄位,這份輸入就是那個樣子;可以對照上面那份乾淨範例,看看解析器容忍到哪裡。

常見問題

JSON 轉 CSV 時,粗體、斜體與顏色會留下嗎?

行內強調會留下,樣式表不會。粗體、斜體、底線與顏色會寫成 CSV 文字裡的標籤(<i>、<b>、<u>、<font color="…">),這是 cue 層級格式還帶得動的部分;JSON 檔的全域樣式表——字型、字號、描邊、陰影與邊距——則整份丟掉。

JSON 轉 CSV 時,螢幕上的位置會被保留嗎?

CSV 不能指定字幕畫在哪裡,所以每條 cue 儲存的位置在轉出時丟掉,播放器會回到它自己的預設位置——大多數播放器是畫面底部置中。

JSON 轉 CSV 時,卡拉OK計時會留下嗎?

時間會丟,字會留。卡拉OK記在 JSON cue 的區間標記裡,標出每個音節何時亮起;CSV 沒有辦法記錄一行之內的時間點,所以標記拿掉,音節變成普通文字。

JSON 轉成 CSV 的產物長什麼樣子?

CSV 產物是一列表頭 start,end,text,之後一列一條字幕。JSON 的每一條 cue 依序變成一列,時間寫成 00:00:04.126。

JSON 轉 CSV 時,時間碼會失真嗎?

不會。JSON 的 4126 毫秒寫成 CSV 的 00:00:04.126,兩邊都是毫秒精度,原本 2.9 秒的 cue 仍然 2.9 秒。

JSON 裡同一條字幕的兩行,轉成 CSV 後還綁在一起嗎?

JSON 轉 CSV:還是一條。兩行會留在同一個 text 欄位裡,整個欄位用雙引號包起來,換行因此不會被當成新的一列。

JSON 的 cue 順序在 CSV 檔裡會重排嗎?

會按開始時間排序,最早的在前。JSON 的每一條字幕進到 CSV 都照這個順序寫;若原檔本來是亂的,產物會把它們排回正確順序——改的是結構,不是內容,這也是本站每個格式共用的讀檔順序。

把 CSV 轉回 JSON 會再丟東西嗎?

不會再丟,但要說清楚:CSV 轉 JSON 不會丟東西(CSV 能表達的 JSON 都接得住);可是這一趟丟掉的樣式、定位與卡拉OK不在 CSV 檔裡,補不回來。

JSON 轉 CSV 的產物用什麼編碼與換行?

一律是 UTF-8、Unix 換行(LF)、不帶 BOM,不管 JSON 原檔用什麼。若輸入是 UTF-16 或 Windows 單一位元編碼,讀入時會先解碼,結果面板會說明;CSV 產物永遠是同一種 UTF-8。

相關工具