External ASS Subtitles

2Horse · September 3, 2026, 2:21am


	Summary	Displays external ASS/SSA subtitles using JASSUB while preserving their original styling, positioning and formatting. Also provides a custom CC menu for external ASS, SSA, SRT and VTT tracks.
	Repository	https://github.com/ProudRykar/external-ass-subtitles
	Source URL	https://proudrykar.github.io/stash-plugins/main/index.yml
	Install	How to install a plugin?

External ASS Subtitles

External ASS/SSA subtitle renderer for Stash using JASSUB.

The plugin is intended for external subtitle files located alongside scene video files. ASS/SSA subtitles are rendered using JASSUB to preserve ASS styling and positioning that cannot be fully represented by the browser’s native subtitle renderer.

The plugin does not extract or modify embedded subtitle tracks.

What it does

Automatically discovers external subtitle files matching the scene video.
Supports ASS, SSA, SRT and VTT subtitle files.
Renders ASS/SSA subtitles using JASSUB.
Provides a custom CC menu for all supported external subtitle formats.
Can integrate ASS/SSA tracks into Stash’s native CC menu.
Supports multiple external subtitle tracks.
Detects common language codes from subtitle filenames.
Detects subtitle source information from filenames.
Optionally searches subtitle subdirectories.
Supports UTF-8, UTF-8 BOM, CP1251 and Japanese encodings.

SRT and VTT are handled by Stash’s existing Video.js subtitle support. The plugin’s custom CC menu provides a unified way to select them alongside ASS/SSA tracks.

Subtitle naming

Subtitle files are matched to the scene video by filename.

For example:

Episode 01.mp4
Episode 01.eng.ass
Episode 01.eng_SubDESU-H.ass
Episode 01.eng_MuchoHentai.ass
Episode 01.ru.srt
Episode 01.ru.vtt

Language codes such as en, eng, ru, rus, ja, jpn, de, fr, es, it, pt, zh and ko are recognized.

Additional filename information can be used as a subtitle source. For example:

Episode 01.eng_SubDESU-H.ass

is displayed as:

English — SubDESU-H

Why ASS/SSA?

Stash already supports external SRT and VTT subtitles. ASS/SSA files contain additional styling and positioning information that cannot be represented by a standard browser text track.

Instead of converting ASS/SSA subtitles to SRT and losing that information, this plugin renders the original ASS/SSA file using JASSUB.

This preserves features such as:

Font selection
Font size
Colors
Outline and shadow
Positioning
Alignment
Margins
Styles
ASS override tags

JASSUB uses the fonts bundled with the plugin as fallback fonts when a requested font is not available.

Custom CC

The plugin provides an optional custom CC menu for external subtitle tracks.

It supports:

ASS
SSA
SRT
VTT

ASS/SSA tracks are rendered by JASSUB, while SRT/VTT tracks are passed to the native Video.js text-track system.

Configuration

The plugin provides the following settings:

Search subtitle subdirectories — Also search subdirectories next to the scene video.
Show subtitles by default — Automatically enable the first external subtitle track.
Use native CC menu — Use Stash’s native CC menu instead of the custom subtitle selector.