utkarsh2299's picture
Update README.md
6913460 verified
---
license: cc-by-4.0
tags:
- lipsync
- dubbing
- tts
- asr
- mt
- nptel
---
# Lip-Sync Video Generation
This project generates a lip-synced video based on an original video and translated subtitles.
generate_Lipsync_videos - In this project, we maintained the constant speed of the audio and slowed down the video by interpolating the video frames. This approach ensured proper synchronization between the audio and video, resulting in a video duration longer than the original.
## Prerequisites
- Conda
- Python 3.8
## Setup
1. Clone the repository:
```bash
git clone https://huggingface.co/smtiitm/generate_lipsynced_videos_IITM_API
cd generate_lipsynced_videos_IITM_API #generate_Lipsync_videos
```
2. Create and activate the conda environment:
```bash
conda create -n lipsync_env python=3.8
conda activate lipsync_env
```
3. Install the required packages:
```bash
pip install -r requirements.txt
```
4. Currently the code uses our APIs for text-to-speech generation. You can use your own TTS API (make sure to use the correct payload given in `vtt_to_speech.py` file) URL in `srt_to_audio_original` file. The current APIs are local to the lab and can be requested via mail.
## Usage
1. Edit the `run_script.sh` file to assign the paths to your original video and translated subtitles:
```bash
original_video_path="path/to/original_video.mp4"
translated_srt_path="path/to/translated_subtitles.srt"
```
2. Assign the target language code in `run_script.sh`:
```bash
target_language_code="hin" # Example: 'hin' for Hindi
```
3. Run the script:
```bash
./run_script.sh
```
4. Current supported sampling rate is 22.5KHz and .wav format is preferred.
## Supported Languages
- Hindi (hin)
- Malayalam (mal)
- Kannada (kan)
- Bengali (bn)
- Urdu (ur)
- Telugu (tel)
- Punjabi (pun)
- Marathi (mar)
- Gujarati (guj)
- Tamil (tam)
- English (en)
### Citation
If you use this repo in your research or work, please consider citing:
COPYRIGHT
2025, Speech Technology Consortium,
Bhashini, MeiTY and by Hema A Murthy & S Umesh,
DEPARTMENT OF COMPUTER SCIENCE AND ENGINEERING
and
ELECTRICAL ENGINEERING,
IIT MADRAS. ALL RIGHTS RESERVED "
Shield: [![CC BY 4.0][cc-by-shield]][cc-by]
This work is licensed under a
[Creative Commons Attribution 4.0 International License][cc-by].
[![CC BY 4.0][cc-by-image]][cc-by]
[cc-by]: http://creativecommons.org/licenses/by/4.0/
[cc-by-image]: https://i.creativecommons.org/l/by/4.0/88x31.png
[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg