https://github.com/0xdolan/Subtitle-Fixer

The Subtitle Fixer is a simple tool that helps you fix subtitles in Kurdish (ckb), Persian, and Arabic
https://github.com/0xdolan/Subtitle-Fixer

arabic encoding kurdish persian python subtitle utf-8

Last synced: 3 months ago
JSON representation

The Subtitle Fixer is a simple tool that helps you fix subtitles in Kurdish (ckb), Persian, and Arabic

• Host: GitHub
• URL: https://github.com/0xdolan/Subtitle-Fixer
• Owner: 0xdolan
• License: gpl-3.0
• Created: 2023-01-14T17:15:44.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-12T08:34:14.000Z (almost 2 years ago)
• Last Synced: 2024-06-28T07:32:15.654Z (5 months ago)
• Topics: arabic, encoding, kurdish, persian, python, subtitle, utf-8
• Language: Python
• Homepage:
• Size: 7.66 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Subtitle Fixer

**Subtitles** and captions are lines of dialogue or other text displayed at the bottom of the screen in films, television programs, video games or other visual media. They can be transcriptions of the screenplay, translations of it, or information to help viewers who are deaf or hard-of-hearing understand what is shown ([*wikipedia*](https://en.wikipedia.org/wiki/Subtitles)).

![subtitle_example](./images/subtitle_example.png)

The **Subtitle Fixer** is a simple tool that helps you fix subtitles in *Kurdish (ckb)*, *Persian*, and *Arabic*.

If you have ever encountered issues (*see below images*) when watching a movie with its subtitles, you have come to the right place to find a solution.

##### The following images are examples of subtitle files that require fixing

![subtitle_image_1](./images/subtitle_1.png)

![subtitle_image_2](./images/subtitle_2.png)

![subtitle_image_3](./images/subtitle_3.png)

![subtitle_image_4](./images/subtitle_4.png)

#### NOTE:

Only implement these codes on subtitle files that have issues. If you are proficient in Python and Unicode, you can use the necessary encodings for your files.

## How to Use

- Clone the repo

- Make sure all your subtitles are in the same directory as the repo

- Create a new file with a `.py` extension (e.g. `example.py`) and copy the provided code into it

```python

# -*- coding: utf-8 -*-

# import essential modules

import io

import sys

from pathlib import Path

# solve encoding problems

sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8")

sys.stdin = io.TextIOWrapper(sys.stdin.buffer, encoding="utf-8")

# import subtitle_fixer module

from subtitle_fixer import Subtitle_Fixer

# get current directory

current_directory = Path(__file__).parent

# get all files in current directory

srt_files = current_directory.iterdir()

# make an instance of Subtitle_Fixer class

subt = Subtitle_Fixer()

# find subtitles based on their extensions

# and fix encoding of all subtitle files

fix = [

    subt.fix_encoding(s)

    for s in srt_files

    if str(s.name).split(".")[-1] in subt.subtitle_extensions

]

```

- Run the file using the command line

The entire process is outlined in the `example.py` file and can be easily executed using the following command:

- **Linux** or *Mac*: python `./example.py`

- **Windows**: `python .\example.py` or `python .//example.py`

Once you run the script, all subtitle files in the directory will be fixed and renamed, adding a `_fixed` suffix to the file name.

#### NOTE:

Fixed file has been encoded to `UTF-8` and you can set your subtitle settings in your player to `UTF-8`.

##### The following images are examples of fixed subtitles

![subtitle_image_5](./images/subtitle_5.png)

![subtitle_image_6](./images/subtitle_6.png)

## Using VS-Code as an alternative method

#### NOTE:

This method does not automatically set the encoding type to `UTF-8` and requires manual configuration of subtitle settings in the player.

![vscode](./images/vscode.gif)

## Bugs & Issues

Please feel free to report any bugs or issues to us, email to: [email protected] or open issues on Github.

## License

Licensed under the GPLv3 License.