Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/victorwoo/transcript-video

A PowerShell script that automatically generates subtitles in bulk for video files using whisper-ctranslate2.
https://github.com/victorwoo/transcript-video

batch generative-ai openai powershell script subtitle video video-processing

Last synced: 28 days ago
JSON representation

A PowerShell script that automatically generates subtitles in bulk for video files using whisper-ctranslate2.

Host: GitHub
URL: https://github.com/victorwoo/transcript-video
Owner: victorwoo
License: mit
Created: 2024-10-29T01:09:51.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-11-09T09:10:28.000Z (2 months ago)
Last Synced: 2024-11-09T10:18:56.951Z (2 months ago)
Topics: batch, generative-ai, openai, powershell, script, subtitle, video, video-processing
Language: PowerShell
Homepage: https://github.com/victorwoo/transcript-video
Size: 14.2 MB
Stars: 3
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md

Awesome Lists containing this project

README

# Transcript Video Script

A [PowerShell](https://learn.microsoft.com/en-us/powershell/) script that automatically generates `.srt` subtitles in bulk for video files using `whisper-ctranslate2`.

![Banner](./Images/Banner.png)

## Features

- **Video Transcription**: Supports .mp4, .avi, mkv, and .mov formats.
- **Subtitle Management**: Removes existing subtitle files with .json, .tsv, .txt, or .vtt extensions.
- **Progress Tracking**: Provides a progress bar to monitor the process.
- **Verbose Mode**: Display detailed execution information when `-Verbose` is used.

## Screen Shots

Running the script:

![running script](./Images/Screen%20shot%20-%20001.png)

The video has been subtitled and is displayed correctly in the player:

![subtitled video](./Images/Screen%20shot%20-%20002.png)

## Prerequisites

- [Python](https://www.python.org/) environment must be installed on your system.
- Install the `whisper-ctranslate2` Python package using the following command:

```powershell
pip install -U whisper-ctranslate2
```

- For more information, visit the official repository:

## Usage

### Basic Usage

To process all video files in the current directory:

```powershell
PS> .\TranscriptVideo.ps1
```

### Process a Specific Folder

To specify the folder containing video files:

```powershell
PS> .\TranscriptVideo.ps1 -FolderPath "C:\Videos"
```

### Enable Verbose Mode

To display detailed output:

```powershell
PS> .\TranscriptVideo.ps1 -Verbose
```

## Parameters

- **FolderPath**: (Optional) The path to the folder containing video files. If not provided, the current directory will be used.

## Example

```powershell
PS> .\TranscriptVideo.ps1 -FolderPath "C:\Videos" -Verbose
```

Processes all video files in C:\Videos with detailed output enabled.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Author

- [Victor Woo](https://github.com/victorwoo)