https://github.com/agermanidis/autosub

[NO LONGER MAINTAINED] Command-line utility for auto-generating subtitles for any video file
https://github.com/agermanidis/autosub

Last synced: 20 days ago
JSON representation

[NO LONGER MAINTAINED] Command-line utility for auto-generating subtitles for any video file

• Host: GitHub
• URL: https://github.com/agermanidis/autosub
• Owner: agermanidis
• License: mit
• Created: 2015-06-29T04:15:09.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-03-22T15:28:35.000Z (8 months ago)
• Last Synced: 2024-10-01T15:21:31.738Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 72.3 KB
• Stars: 4,139
• Watchers: 134
• Forks: 1,643
• Open Issues: 130
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred-test - agermanidis/autosub - [NO LONGER MAINTAINED] Command-line utility for auto-generating subtitles for any video file (Python)
• starred-awesome - autosub - Command-line utility for auto-generating subtitles for any video file (Python)

README

        
# Autosub 

  

### Auto-generated subtitles for any video

Autosub is a utility for automatic speech recognition and subtitle generation. It takes a video or an audio file as input, performs voice activity detection to find speech regions, makes parallel requests to Google Web Speech API to generate transcriptions for those regions, (optionally) translates them to a different language, and finally saves the resulting subtitles to disk. It supports a variety of input and output languages (to see which, run the utility with the argument `--list-languages`) and can currently produce subtitles in either the [SRT format](https://en.wikipedia.org/wiki/SubRip) or simple [JSON](https://en.wikipedia.org/wiki/JSON).

### Installation

1. Install [ffmpeg](https://www.ffmpeg.org/).

2. Run `pip install autosub`.

### Usage

```

$ autosub -h

usage: autosub [-h] [-C CONCURRENCY] [-o OUTPUT] [-F FORMAT] [-S SRC_LANGUAGE]

               [-D DST_LANGUAGE] [-K API_KEY] [--list-formats]

               [--list-languages]

               [source_path]

positional arguments:

  source_path           Path to the video or audio file to subtitle

optional arguments:

  -h, --help            show this help message and exit

  -C CONCURRENCY, --concurrency CONCURRENCY

                        Number of concurrent API requests to make

  -o OUTPUT, --output OUTPUT

                        Output path for subtitles (by default, subtitles are

                        saved in the same directory and name as the source

                        path)

  -F FORMAT, --format FORMAT

                        Destination subtitle format

  -S SRC_LANGUAGE, --src-language SRC_LANGUAGE

                        Language spoken in source file

  -D DST_LANGUAGE, --dst-language DST_LANGUAGE

                        Desired language for the subtitles

  -K API_KEY, --api-key API_KEY

                        The Google Translate API key to be used. (Required for

                        subtitle translation)

  --list-formats        List all available subtitle formats

  --list-languages      List all available source/destination languages

```

### License

MIT