https://github.com/appatalks/ukrainian-whisper-ai
Transcribe Ukrainian with translation to English text to SRT format.
https://github.com/appatalks/ukrainian-whisper-ai
openai-api speech-to-text translation ukrainian video-editing whisper-ai
Last synced: 6 months ago
JSON representation
Transcribe Ukrainian with translation to English text to SRT format.
- Host: GitHub
- URL: https://github.com/appatalks/ukrainian-whisper-ai
- Owner: appatalks
- License: gpl-3.0
- Created: 2024-03-29T01:30:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-12T18:32:18.000Z (about 1 year ago)
- Last Synced: 2025-04-10T04:58:58.758Z (6 months ago)
- Topics: openai-api, speech-to-text, translation, ukrainian, video-editing, whisper-ai
- Language: Shell
- Homepage: https://platform.openai.com/docs/guides/speech-to-text/quickstart
- Size: 36.1 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ukrainian-whisper-ai
## OpenAI Audio Transcription and Translation Script
> [!IMPORTANT]
> Transcribe Ukrainian with translation to English text to SRT format. OpenAI transcription/translation API Endpoints
Leverages the OpenAI API to transcribe audio files and translate the transcriptions into English and Ukrainian SRT (SubRip subtitle) files. Using OpenAI's Whisper model, specifically targets Ukrainian language audio for transcription. This tool is designed to handle audio files directly, manage file size constraints by splitting large files, and process both the transcription and translation phases automatically.
## Features
- **transcribe_ukrainian.sh**: Converts audio to text using the Whisper model, with a focus on Ukrainian audio content.
- **translation_to_english.sh**: Translates audio to English text using the Whisper model.
- **File Size Management**: Splits files larger than 25MB into smaller segments to comply with API limitations.
- **Automated Workflow**: From a single audio file input, produces an SRT file containing both transcribed and translated text.
## Requirements
- Bash shell (Linux, macOS)
- `curl` for making API requests
- `ffmpeg` for splitting large audio files into manageable segments
- `jq` for parsing JSON responses
## Setup
1. Ensure all required tools (`curl`, `ffmpeg`, `jq`) are installed on your system.
2. Place the script in a desired directory.
## Usage
1. Open a terminal and navigate to the directory containing the script.
2. Make the script executable with the following command:
```chmod +x run.sh```
3. Run the script by providing the path to the audio file as an argument:
```bash ./run.sh /path/to/your/audio_file.mp3```
4. When prompted, enter your OpenAI API key. This key is required to authenticate API requests for transcription and translation.
## Important Notes
- The script is designed to work with audio files specifically in the Ukrainian language for the initial transcription process. Adjustments may be needed for other languages.
- API costs: Using the OpenAI API for transcription and translation may incur costs. Please check the current OpenAI pricing and your usage quota before running the script.
## Output
- The script generates two main outputs:
- A `.json` file with the transcribed text in Ukrainian.
- An `.srt` file with both the original Ukrainian transcription and the appended English translation, ready for use as subtitles.