Skip to main content

Tatt creates a uniform API for multiple speech-to-text (STT) services.

Project description

Transcribe All The Things™

tatt is a CLI for creating and managing speech-to-text transcripts.

demo

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 <path_to_media_file> using <service_name>...
Okay, job <job_name> is being transcribed.  Use "get" command to download it.

List Transcripts

$ transcribe list

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>

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>

Okay, downloaded <job_name>.json

Services Supported

Planned

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tatt-0.944.tar.gz (5.9 kB view hashes)

Uploaded Source

Built Distribution

tatt-0.944-py3-none-any.whl (20.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page