ASS GUIDE

ASS is the Pro format for positioned pinyin above Hanzi.

ASS subtitles are not just another download option. They are the format that makes advanced Chinese learning layout possible because they can carry positioning, style, margins, and frame-aware placement.

WHY ASS EXISTS

Aligned pinyin needs a layout format, not a plain text format.

Pinyin above Hanzi sounds simple until the subtitle leaves the browser preview. A web page can use HTML and CSS to place small pinyin text above each Chinese character. A normal SRT file cannot describe that relationship reliably. It can only describe timed text lines. ASS is different. It can include style definitions, screen resolution, alignment, margins, and positioned dialogue events. That makes it the right format when the visual arrangement is part of the product value.

For SubChinese, ASS is the Pro layer because it solves a harder problem than transcription. The user is no longer asking for text alone; they are asking for a learning display. The pinyin should feel attached to the Hanzi. The subtitle should not collide with a speaker name, platform caption, or lower-third graphic. A vertical video should not use the same margins as a landscape lecture. These are layout problems, and layout belongs in ASS.

The technical advantage is that the same timed segments can feed a richer renderer. The Chinese text, pinyin, translation note, start time, end time, and canvas preset are already connected. ASS export can use that structure to produce a styled file without asking the user to manually rebuild timing. That is the core of the Pro value: not more text, but better placement of the text.

What a SubChinese ASS block is meant to do

[Script Info]
ScriptType: v4.00+
PlayResX: 1080
PlayResY: 1920

[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, Alignment, MarginV
Style: Pinyin,Arial,34,&H00F6F1E8,2,250
Style: Hanzi,Arial,52,&H00FFFFFF,2,190
Style: English,Arial,30,&H00D7E4DB,2,130

[Events]
Format: Start, End, Style, Text
Dialogue: 0:00:01.00,0:00:03.50,Pinyin,nǐ hǎo hěn gāo xìng
Dialogue: 0:00:01.00,0:00:03.50,Hanzi,你好,很高兴
Dialogue: 0:00:01.00,0:00:03.50,English,Nice to meet you.

ASS is meant to carry timing and layout together. The same sentence can have a pinyin layer, a larger Hanzi layer, and a smaller English note, each with its own style and vertical position. That is why ASS is the stronger Pro format: it protects the learning view after the subtitle leaves the browser preview.

In production, SubChinese can generate different ASS presets for landscape, square, and vertical video. The user should not need to understand subtitle styling syntax; the export should already know where pinyin belongs, where Hanzi belongs, and how much room the English note should take.

TECHNICAL ITERATION

The iteration advantage is frame-aware learning layout.

The first technical step is extracting speech and creating timed Chinese segments. The second is generating pinyin from the Chinese text, so corrections to Hanzi can also correct the pinyin layer. The third is export. This is where ASS matters: it can use the selected canvas preset to decide font size, vertical spacing, margins, and subtitle placement. Landscape, square, social, and vertical videos should not be treated as the same surface.

This helps users in a practical way. They do not need to know subtitle styling syntax. They do not need to hand-position lines. They do not need to guess why pinyin looked fine in a browser but became messy in a player. The tool turns a complicated subtitle layout decision into a Pro export choice. That is a clearer product promise than saying every format does everything.

ASS also supports a cleaner roadmap. We can improve placement rules, font sizing, line wrapping, and canvas presets without changing the user mental model. SRT remains the compatibility file. ASS becomes the format where our layout engine keeps getting better. That creates a real technical moat over simple transcription wrappers because the value compounds in the renderer, not only in the ASR call.

PRO USE CASES

ASS is worth paying for when the visual relationship matters.

  • Character studyUse ASS when learners need to see pronunciation directly above the characters, not as a loose paragraph.
  • Vertical clipsUse ASS when the subtitle area must fit a short-form video frame without covering important visual content.
  • Tutor materialsUse ASS when a teacher wants a cleaner playback file for class review instead of a rough transcript.
  • Repeat viewingUse ASS when the same video will be watched repeatedly and the layout quality saves attention every time.