Transcribe All The Things™
Tatt creates a uniform API for multiple speech-to-text (STT) services.
Installation
pip install tatt
Dependencies
An AWS account (the only supported STT provider as of Feb 12, 2019), and a recording to transcribe!
Usage
List All Commands
transcribe --help
Usage: transcribe [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
get Downloads and/or saves completed transcript.
list Lists available STT services.
services Lists available speech-to-text services.
this Sends a media file to be transcribed.
List All STT Services
transcribe services
Here are all the available speech-to-text services:
amazon (60 minutes per month for the first 12 months)
Get Something Transcribed
transcribe this <path_to_media_file> <service_name>
Okay, transcribing /Users/zev/d/<path_to_media_file> using <service_name>...
Okay, job <path_to_media_file> is being transcribed. Use "get" command to download it.
List Transcripts
transcribe list # a full list of all transcripts, completed and in_progress
Service Job Name Status
------- -------- ------
amazon tester.mp3 IN_PROGRESS
amazon messed_up.mp4 FAILED
amazon done_test.mp3 COMPLETED
amazon also_done.MP3 COMPLETED
transcribe list <job_name> # the status of a particular transcript
Service Job Name Status
------- -------- ------
amazon <job_name> IN_PROGRESS
Get A Completed Transcript
transcript get <job_name> # prints to stdout
{'accountId': '416321668733',
'jobName': 'a1bace5e-8b08-4ce4-b08c-834a23aafcf1',
'results': {'items': [{'alternatives': [{'confidence': '0.9774',
'content': 'Hi'}],
'end_time': '1.5',
'start_time': '1.23',
'type': 'pronunciation'},
{'alternatives': [{'confidence': '0.9429',
'content': 'is'}],
'end_time': '1.71',
'start_time': '1.5',
'type': 'pronunciation'},
...
transcript get -f <job_name> # saves to a file in the format <job_name>.json
Okay, downloaded <job_name>.json