Skip to content
Python script which pulls audio from mp4 video and transcribes audio using google speech and cloud storage APIs, returning an srt formatted document and raw text
Branch: master
Clone or download
Latest commit 5b7c636 Sep 25, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.txt Add description to README Sep 25, 2017 Clean up and code commenting Sep 25, 2017 Clean up and code commenting Sep 25, 2017
requirements.txt INITIAL COMMIT Sep 12, 2017 Clean up and code commenting Sep 25, 2017


This script is for extracting and transcribing audio files from .mp4 video files into .srt formatted text files for subtitling purposes using Googles Speech-to-Text and Google Cloud Storage APIs. It outputs both a raw text transcription and a .srt formatted version. In the current version, this script requires you to authenticate your Google credentials through the gcloud CLI and also requires that you have ffmpeg installed locally on your machine (for video to audio conversion and compression)

Instructions for use

Use the Cloud Platform Console to create a new Cloud
Platform project, create an App Engine application, and
enable billing:
(Skip if project already set up)

Enable the Google Speech to Text API
in APIs and Services in new project dashboard

Set up a storage bucket in Google Cloud Storage

Download, install and set up Google SDK
(authenticate your machine by following the auth instructions)

Install ffmpeg
    sudo apt update
    sudo apt install ffmpeg

Set your virtual environment

If you don't have virtualenv, install it using pip.

    sudo pip install virtualenv

Create an isolated Python environment, and install dependencies:

virtualenv env
source env/bin/activate
pip install -r requirements.txt

In change the bucket_name variable to the name of the storage bucket you wish to use

To run transcription script add .mp4 files to a specified directory

Then run:

    python /path/to/directory/

The script will automatically strip the audio files from the video and convert them to .ogg format

The it uploads the audio to the gcloud storage bucket and
then passes its gcs_uri to the speech to text API for processing

When finished, it outputs both the .srt formatted file and raw text file into the specified directory

Note that if the program errors, it terminates as to not potentially abuse any API quota limits
You can’t perform that action at this time.