Перейти к основному содержимому
SubtitleMatrix

Конвертер CSV в JSON

Или вставьте текст субтитров

Что меняет эта конвертация

В этом направлении ничего не теряется — у каждой возможности исходного формата есть куда перейти в целевом.

Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.

Конвертер CSV в JSON нужен, когда плеер или платформа принимает только второй формат: CSV здесь — таблица, которую открывает любой редактор электронных таблиц, JSON — внутренний формат сайта, который хранит полную модель субтитров. CSV записывает интервал (00:00:01.000,00:00:03.500), а JSON хранит его целыми миллисекундами: start 1000, end 3500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.

В этом направлении ничего не теряется: позиционирования в CSV нет, караоке в исходнике отсутствует, служебных блоков вне реплик тоже нет, а CSV не содержит ничего, чего JSON не умел бы.

Сервер не участвует: файл читается и записывается в браузере, поэтому можно обрабатывать пакеты и прерывать очередь в любой момент.

Примеры

Обычный файл CSV, переведённый в JSON

Вход

start,end,text
00:00:01.000,00:00:03.500,The quick brown fox.
00:00:04.000,00:00:06.250,"Jumps over, the lazy dog."
00:00:07.000,00:00:09.000,"Two lines here.
And a second one."

Выход

{
  "version": 1,
  "cues": [
    {
      "start": 1000,
      "end": 3500,
      "lines": [
        "The quick brown fox."
      ]
    },
    {
      "start": 4000,
      "end": 6250,
      "lines": [
        "Jumps over, the lazy dog."
      ]
    },
    {
      "start": 7000,
      "end": 9000,
      "lines": [
        "Two lines here.",
        "And a second one."
      ]
    }
  ]
}

Сравните две стороны: CSV записывает время как 00:00:01.000, JSON — как "start": 1000; текст и порядок реплик при этом сохраняются.

Тот же перевод на неаккуратном файле CSV

Вход

id,start,end,note,text
1,00:00:01,000,00:00:04,000,cue one,"Hello there, friend."
2,00:00:05.000,00:00:07.000,cue two,Second line.
bad,notatime,00:00:09.000,cue three,Unreadable start.
4,00:00:10.000,00:00:09.000,cue four,End before start.
5,00:00:12.000,00:00:14.000,cue five,Unquoted comma in text, right here.

Выход

{
  "version": 1,
  "cues": [
    {
      "id": "1",
      "start": 1000,
      "end": 4000,
      "lines": [
        "Hello there, friend."
      ]
    },
    {
      "id": "2",
      "start": 5000,
      "end": 7000,
      "lines": [
        "Second line."
      ]
    },
    {
      "id": "4",
      "start": 10000,
      "end": 10001,
      "lines": [
        "End before start."
      ]
    },
    {
      "id": "5",
      "start": 12000,
      "end": 14000,
      "lines": [
        "Unquoted comma in text, right here."
      ]
    }
  ]
}

Второй файл намеренно неровный: BOM, переводы строк CRLF. CSV читает его без падения, а JSON записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.

Частые вопросы

Как будут выглядеть таймкоды CSV после перевода в JSON?

CSV записывает интервал (00:00:01.000,00:00:03.500), а JSON хранит его целыми миллисекундами: start 1000, end 3500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.

Чем придётся пожертвовать при экспорте CSV в JSON?

Ничего: позиционирования в CSV нет, караоке в исходнике отсутствует, служебных блоков вне реплик тоже нет, а CSV не содержит ничего, чего JSON не умел бы. Текст, интервалы и порядок реплик переносятся один в один, а различие остаётся только в синтаксисе CSV и JSON.

В каком виде JSON хранит реплики после перевода CSV в JSON?

JSON записывает каждую реплику объектом с полями id, start, end и lines; время — целые миллисекунды (1000 и 3500), поэтому округления нет. Строки CSV становятся элементами lines, а теги оформления — отдельными объектами.

Сохранятся ли переносы строк и порядок реплик при переводе CSV в JSON?

Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки CSV останутся двумя строками в JSON; порядок реплик не меняется.

В какой кодировке сохраняется JSON и какое у него расширение при переводе из CSV?

Файл JSON записывается в UTF-8 без BOM с переводами строк LF и расширением .json; при чтении CSV сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.

Как сайт понимает колонки CSV при переводе в JSON?

В CSV роли колонок определяются по заголовку: start, end и text, причём допускаются синонимы. Всё, что не опознано как время или текст, не попадает в JSON; строки с нечитаемым временем пропускаются и учитываются в отчёте.

Похожие инструменты