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

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

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

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

3 пункта теряются или требуют решения

  • Оформление

    всё оформление (жирный, курсив, цвет, обводка, тень)

  • Позиционирование

    положение на экране (каждая реплика возвращается в стандартное положение)

  • Содержимое формата

    содержимое, которое исходный формат хранит вне реплик (блоки не-реплик, текст заголовка, настройки реплик, закомментированные события): целевому формату его некуда деть

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

TTML — XML-формат для вещания и стриминга, где время и оформление заданы атрибутами, а CSV — таблица, которую открывает любой редактор электронных таблиц; эта страница переводит файл из одного формата в другой. TTML записывает интервал (begin="00:00:01.000" end="00:00:03.500"), а CSV раскладывает его на колонки start и end со значениями 00:00:01.000 и 00:00:03.500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.

Сайт перечисляет потери до запуска — оформление, позиционирование, раздел head TTML; TTML хранит полное оформление через tts-атрибуты, стили и регионы, а CSV умеет только чистый текст: шрифт, цвет, обводка, тень и начертание исчезнут.

Файлы разбираются локально в браузере и не отправляются на сервер; очередь можно остановить, а результаты скачать одним архивом.

Примеры

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

Вход

<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling" xml:lang="en">
  <head>
    <styling>
      <style xml:id="s1" tts:color="#FFFF00" tts:fontWeight="bold"/>
    </styling>
    <layout>
      <region xml:id="bottom" tts:origin="10% 80%" tts:extent="80% 20%"/>
    </layout>
  </head>
  <body>
    <div>
      <p begin="00:00:01.000" end="00:00:03.500" region="bottom" style="s1">Hello <span tts:fontStyle="italic">there</span>.</p>
      <p begin="00:00:03.500" end="00:00:06.000" region="bottom">How are you?<br/>Fine, thanks.</p>
    </div>
  </body>
</tt>

Выход

start,end,text
00:00:01.000,00:00:03.500,Hello <i>there</i>.
00:00:03.500,00:00:06.000,"How are you?
Fine, thanks."

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

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

Вход

<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling"
    xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
    ttp:frameRate="25" xml:lang="en">
  <body>
    <div>
      <p begin="1.5s" dur="2s">Loaded from an offset and a duration.</p>
      <p begin="4s" end="00:00:06.50">A coarser clock spelling.</p>
      <p begin="00:00:07:00" end="00:00:08:12">Frames, at 25fps.</p>
      <p begin="9s"><span tts:color="#FF0000">Half-open</span> and Tom &amp; Jerry.</p>
    </div>
  </body>
</tt>

Выход

start,end,text
00:00:01.500,00:00:03.500,Loaded from an offset and a duration.
00:00:04.000,00:00:06.500,A coarser clock spelling.
00:00:07.000,00:00:08.480,"Frames, at 25fps."
00:00:09.000,00:00:11.000,"<font color=""#FF0000"">Half-open</font> and Tom &amp; Jerry."

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

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

Что происходит с отметками времени при конвертации TTML в CSV?

TTML записывает интервал (begin="00:00:01.000" end="00:00:03.500"), а CSV раскладывает его на колонки start и end со значениями 00:00:01.000 и 00:00:03.500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.

Что исчезнет из файла, если сохранить TTML как CSV?

TTML хранит полное оформление через tts-атрибуты, стили и регионы, а CSV умеет только чистый текст: шрифт, цвет, обводка, тень и начертание исчезнут. TTML расставляет реплики по экрану, а CSV не хранит координат: все реплики вернутся в позицию по умолчанию. TTML хранит пролог и раздел head со стилями, регионами и метаданными, а CSV их не переносит. Это полный список потерь для пары TTML → CSV; сайт показывает его до запуска.

Что сайт читает из head и стилей TTML перед переводом в CSV?

TTML хранит время в begin и end, текст в p, а оформление — в tts-атрибутах, стилях и регионах раздела head. В CSV переносится то, что он умеет: текст и интервалы; стили и регионы теряются, если целевой формат их не поддерживает.

Что произойдёт с многострочными репликами TTML в файле CSV?

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

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

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

Сохранятся ли регионы и стили из head TTML при переводе TTML в CSV?

TTML описывает оформление в разделе head — в стилях, регионах и метаданных. CSV принимает только те возможности, которые умеет сам, поэтому часть стилей и регионов останется в TTML.

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