Skip to content

Commit

Permalink
docs: add basic README file with install and usage instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
andreabak committed Mar 17, 2024
1 parent 431ca2f commit ea08641
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# WhisperSubs

[![Python 3.8](https://img.shields.io/badge/python-3.8-blue.svg)](https://www.python.org/downloads/release/python-380/)
[![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/andreabak/whispersubs/pre-commit.yml?label=pre-commit&branch=main)](https://github.com/andreabak/whispersubs/actions)
[![License](https://img.shields.io/github/license/andreabak/whispersubs)](https://github.com/andreabak/whispersubs/blob/main/LICENSE)

Generate subtitles for your video or audio files using the power of AI.

## Installation

Prerequisites:
- git for cloning this repo
- Python 3.8 or higher, with pip

For faster results, it is recommended to use a GPU with CUDA support.

```shell
# Clone the repo and cd into it
git clone https://github.com/andreabak/whispersubs.git
cd whispersubs

# Install the dependencies
pip install -r requirements.txt
```

## Usage
WhisperSubs can be used from the command line. The basic usage requires an input file, which will be the source for the transcription. The output will be a subtitle file in the SRT format in the same directory as the input file. The language will be automatically detected.
```shell
python -m whispersubs <input_file>
```

For a full list of options, run:
```shell
python -m whispersubs --help
```

0 comments on commit ea08641

Please sign in to comment.