KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

VidSubX

★ 83 Open GitHub ↗

A program for extracting hard coded (burned in) subtitle from a video and generating an external subtitle.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# VidSubX

![python version](https://img.shields.io/badge/Python-3.12-blue)
![support os](https://img.shields.io/badge/OS-Windows%20%7C%20Linux-green.svg)

A free program that extracts hard coded subtitles from a video and generates an external subtitle file.

**Features**

- Detect subtitle area by searching common area.
- Manual resize or change of subtitle area (click and drag mouse to perform).
- Single and Batch subtitle detection and extraction.
- Start and Stop subtitle extraction positions can be selected (use arrow keys for precise selection).
- Switch between Light and Dark Mode under the View menu.
- Resize video display (Zoom In (Ctrl+Plus), Zoom Out (Ctrl+Minus)).
- Non subtitle area of the video can be hidden to limit spoilers.
- An Nvidia GPU can be used to speed up the extraction of the subtitles.
- Auto optimization for CPU config for best performance.
- The released copies can be run without having python installed.
- Toast Notification available on Windows upon completion of subtitle detection and extraction.
- [Preferences docs](docs/Preferences.md) available for modification of options when extraction subtitles.
- Multiple languages supported through [PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR). They will be
  automatically downloaded as needed.

**[Supported languages and Abbreviations](docs/Supported_Languages.md)**

### Generated subtitles can be translated with this [script](https://github.com/voun7/Subtitle_Translator) or [SubtitleEdit](https://github.com/SubtitleEdit/subtitleedit).

### Download

[Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist) must be
installed. The program will not start without it.

- [Latest CPU & GPU Version](https://github.com/voun7/VidSubX/releases/latest)

## Demo Video

[![Demo Video](https://raw.githubusercontent.com/voun7/VidSubX/master/docs/images/demo%20screenshot.png)](https://youtu.be/i_VNDN7AMP4 "Demo Video")

## Setup Instructions

### Download and Install:

[Latest Version of Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist)

**Install packages**

For GPU

```
pip install -r requirements-gpu.txt
```

For CPU

```
pip install -r requirements-cpu.txt
```

**_Note:_** `onnxruntime` and `onnxruntime-gpu` should not both be installed at the same time.

For Linux

```commandline
sudo apt install python3-tk
```

Run `gui.py` to use Graphical interface and `main.py` to use Terminal.

### Compile Instructions

For Linux

```commandline
sudo apt install binutils
```

Run `compiler.py` to build compiled program

VidSubX

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README