Конвертер JSON в CSV
Или вставьте текст субтитров
Что меняет эта конвертация
3 пункта теряются или требуют решения
- Оформление
всё оформление (жирный, курсив, цвет, обводка, тень)
- Позиционирование
положение на экране (каждая реплика возвращается в стандартное положение)
- Караоке
тайминг караоке (подсветка по слогам)
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Конвертер JSON в CSV нужен, когда плеер или платформа принимает только второй формат: JSON здесь — внутренний формат сайта, который хранит полную модель субтитров, CSV — таблица, которую открывает любой редактор электронных таблиц. JSON записывает интервал ("start": 1000, "end": 3500), а CSV раскладывает его на колонки start и end со значениями 00:00:01.000 и 00:00:03.500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Сайт перечисляет потери до запуска — оформление, позиционирование, караоке; JSON хранит все возможности внутренней модели: стили, позиция, караоке и теги в строке, а CSV умеет только чистый текст: шрифт, цвет, обводка, тень и начертание исчезнут.
Сервер не участвует: файл читается и записывается в браузере, поэтому можно обрабатывать пакеты и прерывать очередь в любой момент.
Примеры
Обычный файл 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.
Сравните две стороны: JSON записывает время как "start": 1000, CSV — как 00:00:01.000; текст и порядок реплик при этом сохраняются.
Тот же перевод на неаккуратном файле 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.
Второй файл намеренно неровный: переводы строк CRLF. JSON читает его без падения, а CSV записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Как будут выглядеть таймкоды JSON после перевода в CSV?
JSON записывает интервал ("start": 1000, "end": 3500), а CSV раскладывает его на колонки start и end со значениями 00:00:01.000 и 00:00:03.500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Чем придётся пожертвовать при экспорте JSON в CSV?
JSON хранит все возможности внутренней модели: стили, позиция, караоке и теги в строке, а CSV умеет только чистый текст: шрифт, цвет, обводка, тень и начертание исчезнут. JSON расставляет реплики по экрану, а CSV не хранит координат: все реплики вернутся в позицию по умолчанию. JSON хранит послоговую подсветку, а CSV не поддерживает караоке: останется цельный текст без тайминга слогов. Это полный список потерь для пары JSON → CSV; сайт показывает его до запуска.
Почему из JSON в CSV теряется меньше, чем из других форматов?
JSON хранит полную внутреннюю модель: время в миллисекундах, строки, теги, стили, позиции и караоке. CSV принимает только часть этих полей, поэтому потери определяются возможностями CSV, а не исходником; остальное сайт перечисляет до запуска.
Что произойдёт с многострочными репликами JSON в файле CSV?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки JSON останутся двумя строками в CSV; порядок реплик не меняется.
В какой кодировке сохраняется CSV и какое у него расширение при переводе из JSON?
Файл CSV записывается в UTF-8 без BOM с переводами строк LF и расширением .csv; при чтении JSON сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Как выглядит файл CSV после перевода JSON в CSV?
CSV раскладывает субтитры в таблицу с заголовком start,end,text. Время JSON записывается как 00:00:01.000 и 00:00:03.500, а текст с переносом строки заключается в кавычки, чтобы строка таблицы не разорвалась.