unshackle-dl/unshackle
1
0
Fork 0
forked from kenzuya/unshackle
Code Pull Requests 1 Activity

feat(subtitle): preserve original formatting when no conversion requested

Browse Source 
Add preserve_formatting config option to prevent automatic subtitle processing that strips formatting tags and styling. When enabled (default: true), WebVTT files skip pycaption read/write cycle to preserve tags like <i>, <b>, positioning, and other formatting.
This commit is contained in:
Andy
2025-11-03 23:01:31 +00:00
parent 8b0b3045e3
commit 8a46655d21
2 changed files with 20 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
unshackle/core/tracks/subtitle.py
View File

@@ -239,7 +239,11 @@ class Subtitle(Track):
# Sanitize WebVTT timestamps before parsing # Sanitize WebVTT timestamps before parsing
text = Subtitle.sanitize_webvtt_timestamps(text) text = Subtitle.sanitize_webvtt_timestamps(text)
preserve_formatting = config.subtitle.get("preserve_formatting", True)
if preserve_formatting:
self.path.write_text(text, encoding="utf8")
else:
try: try:
caption_set = pycaption.WebVTTReader().read(text) caption_set = pycaption.WebVTTReader().read(text)
Subtitle.merge_same_cues(caption_set) Subtitle.merge_same_cues(caption_set)

4
unshackle/unshackle-example.yaml
View File

@@ -360,6 +360,10 @@ subtitle:
# convert_before_strip: Auto-convert VTT/other formats to SRT before using subtitle-filter # convert_before_strip: Auto-convert VTT/other formats to SRT before using subtitle-filter
# This ensures compatibility when subtitle-filter is used as fallback (default: true) # This ensures compatibility when subtitle-filter is used as fallback (default: true)
convert_before_strip: true convert_before_strip: true
# preserve_formatting: Preserve original subtitle formatting (tags, positioning, styling)
# When true, skips pycaption processing for WebVTT files to keep tags like <i>, <b>, positioning intact
# Combined with no sub_format setting, ensures subtitles remain in their original format (default: true)
preserve_formatting: true
# Configuration for pywidevine's serve functionality # Configuration for pywidevine's serve functionality
serve: serve: