Конвертер CSV в VTT
Или вставьте текст субтитров
Что меняет эта конвертация
В этом направлении ничего не теряется — у каждой возможности исходного формата есть куда перейти в целевом.
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Перевод CSV в VTT меняет не содержание, а способ записи: CSV — таблица, которую открывает любой редактор электронных таблиц, VTT — веб-формат субтитров с обязательной строкой WEBVTT в начале файла. Начало, которое CSV записывает как 00:00:01.000, в VTT выглядит как 00:00:01.000: значения времени сохраняются, меняется только синтаксис. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
В этом направлении ничего не теряется: позиционирования в CSV нет, караоке в исходнике отсутствует, полный интервал и многострочный текст VTT хранит, а CSV не содержит ничего, чего VTT не умел бы.
Обработка идёт на вашем устройстве, без регистрации и без передачи файлов: пакет из нескольких серий обрабатывается по очереди.
Примеры
Обычный файл CSV, переведённый в VTT
Вход
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."
Выход
WEBVTT
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.
Сравните две стороны: CSV записывает время как 00:00:01.000, VTT — как 00:00:01.000; текст и порядок реплик при этом сохраняются.
Тот же перевод на неаккуратном файле 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.
Выход
WEBVTT
1
00:00:01.000 --> 00:00:04.000
Hello there, friend.
2
00:00:05.000 --> 00:00:07.000
Second line.
4
00:00:10.000 --> 00:00:10.001
End before start.
5
00:00:12.000 --> 00:00:14.000
Unquoted comma in text, right here.
Второй файл намеренно неровный: BOM, переводы строк CRLF. CSV читает его без падения, а VTT записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Сохранится ли точность таймкода CSV в файле VTT?
Начало, которое CSV записывает как 00:00:01.000, в VTT выглядит как 00:00:01.000: значения времени сохраняются, меняется только синтаксис. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Что именно теряется при конвертации CSV в VTT?
Ничего: позиционирования в CSV нет, караоке в исходнике отсутствует, полный интервал и многострочный текст VTT хранит, а CSV не содержит ничего, чего VTT не умел бы. Текст, интервалы и порядок реплик переносятся один в один, а различие остаётся только в синтаксисе CSV и VTT.
Зачем в начале файла VTT появляется строка WEBVTT при переводе CSV в VTT?
Это обязательный заголовок VTT: без него плеер не считает файл субтитрами. В CSV такого заголовка нет, поэтому сайт добавляет его и переписывает таймкоды с запятой на точку, сохраняя начало и конец до миллисекунды.
Не перепутается ли порядок реплик после конвертации CSV в VTT?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки CSV останутся двумя строками в VTT; порядок реплик не меняется.
В какой кодировке сохраняется VTT и какое у него расширение при переводе из CSV?
Файл VTT записывается в UTF-8 без BOM с переводами строк LF и расширением .vtt; при чтении CSV сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Как сайт понимает колонки CSV при переводе в VTT?
В CSV роли колонок определяются по заголовку: start, end и text, причём допускаются синонимы. Всё, что не опознано как время или текст, не попадает в VTT; строки с нечитаемым временем пропускаются и учитываются в отчёте.