pengchujin/jzsub

What it solves

JZSub automates the tedious process of downloading high-quality videos from various platforms and creating professional-looking bilingual subtitles. It eliminates the need to manually download video files, extract subtitles, translate them using external tools, and burn them into the video using editing software.

How it works

The tool uses yt-dlp to fetch the highest quality video and audio streams from platforms like YouTube, Bilibili, Vimeo, TikTok, and others. It then processes the subtitles through a GPT-based translation pipeline that uses compact batching and context-aware衔接 to ensure translation quality. Finally, it uses FFmpeg and libass to render the translated bilingual subtitles (using the MiSans font) directly into the MP4 file, with specific adaptations for both landscape and portrait (vertical) videos.

Who it’s for

Content creators, learners, and researchers who need to download foreign-language videos with accurate, burned-in bilingual subtitles for offline viewing or sharing.

Highlights

• Multi-platform Support: Works with any site supported by yt-dlp.
• AI-Powered Translation: Uses GPT for bilingual translation with context preservation across batches.
• Automated Hard-coding: Automatically burns subtitles into the video with adaptive layouts for vertical and horizontal screens.
• Flexible Delivery: Users can choose to receive the full processed video, just the raw video, just the subtitles, or only the bilingual subtitle files.
• Browser Integration: Can read Chrome login states directly for authenticated content without exporting cookies manually.