Export Templates

mpvQC uses the Jinja template engine to customize how QC reports are exported: templates control the format and structure of the documents written by the export menu.

Templates are made for human-readable output. If you want to feed QC data into scripts or other tooling, you don’t need a template: mpvQC saves QC documents in a versioned JSON format with a JSON Schema per version, designed exactly for that.

Getting Started

In mpvQC, open the app data folder via Help → Open App Data Folder…
Create a new file with the .jinja extension (e.g., MyTemplate.jinja) in the export-templates directory
Edit the template file using any text editor
Restart mpvQC to load the new template

Once loaded, your custom template appears as a new entry under File → Export QC Document.

Template Reference

In addition to standard Jinja expressions, mpvQC provides the following properties and filters:

Report Metadata

Property	Type	Description
`write_date`	`bool`	Whether to include the export date/time
`date`	`str`	Current date/time as `yyyy-MM-dd HH:mm`
`write_generator`	`bool`	Whether to include the generator information
`generator`	`str`	mpvQC version string (e.g., “mpvQC 0.9.0”)

Video

Property	Type	Description
`write_video_path`	`bool`	Whether to include the video file path
`video_path`	`str`	Absolute path to the video file (empty if no video loaded)
`video_name`	`str`	Video filename with extension (empty if no video loaded)

User

Property	Type	Description
`write_nickname`	`bool`	Whether to include the user’s nickname
`nickname`	`str`	User’s nickname for report attribution

Subtitles

Property	Type	Description
`write_subtitle_paths`	`bool`	Whether to include manually imported subtitle paths
`subtitles`	`list[str]`	List of subtitle file paths

Comments

comments is a list of dictionaries, one per comment:

Key	Type	Description
`time`	`int`	Time in seconds
`time_ms`	`int`	Time in milliseconds
`commentType`	`str`	Type of comment
`comment`	`str`	The comment text

Filters

Filter	Purpose	Usage
`as_time`	Converts seconds to `HH:mm:ss` format	`{{ comment['time'] \| as_time }}` → `00:00:00`
`as_time_ms`	Converts milliseconds to `HH:mm:ss.zzz`	`{{ comment['time_ms'] \| as_time_ms }}` → `00:15:29.340`
`as_comment_type`	Translates comment type to user’s language	`{{ comment['commentType'] \| as_comment_type }}` → Localized type name

Example: The Classic Template

mpvQC uses this template internally for the built-in mpvQC Classic export:

[FILE]
{{ 'date      : ' + date + '\n'       if write_date       else '' -}}
{{ 'generator : ' + generator + '\n'  if write_generator  else '' -}}
{{ 'nick      : ' + nickname + '\n'   if write_nickname   else '' -}}
{{ 'path      : ' + video_path + '\n' if write_video_path else '' -}}
{% for subtitle in subtitles if write_subtitle_paths -%}
  subtitle  : {{ subtitle }}
{% endfor -%}

{{ '\n' }}[DATA]
{% for comment in comments -%}
[{{ comment['time'] | as_time }}] [{{ comment['commentType'] | as_comment_type }}] {{ comment['comment'] | trim }}
{% endfor -%}
# total lines: {{ comments | count }}