Questions? Comments? Feedback?

A library for working with praat, time aligned audio transcripts, and audio files that comes with batteries included.

Praat uses a file format called textgrids, which are time aligned speech transcripts. This library isn't just a data struct for reading and writing textgrids--many utilities are provided to make it easy to work with with transcripts and associated audio files. This library also provides some other tools for use with praat.

Praat is an open source software program for doing phonetic analysis and annotation of speech. Praat can be downloaded here

Table of contents

  1. Common Use Cases
  2. Documentation
  3. Tutorials
  4. Version History
  5. Requirements
  6. Usage
  7. Installation
  8. Citing praatIO
  9. Acknowledgements

Common Use Cases

What can you do with this library?


Automatically generated pdocs can be found here:


There are tutorials available for learning how to use PraatIO. These are in the form of IPython Notebooks which can be found in the /tutorials/ folder distributed with PraatIO.

You can view them online using the external website Jupyter:

Tutorial 1: An introduction and tutorial

Version History

Praatio uses semantic versioning (Major.Minor.Patch)

Ver 4.1 (May 13, 2020)

Ver 4.0 (February 5, 2020)

Ver 3.8 (July 24, 2019)

Ver 3.7 (March 17, 2019)

Ver 3.6 (May 05, 2017)

Ver 3.5 (April 04, 2017)

Ver 3.4 (February 04, 2017)

Ver 3.3 (June 27, 2016)

Ver 3.2 (January 29, 2016)

Ver 3.1 (December 16, 2015)

Ver 3.0 (November 10, 2015)

Ver 2.1 (July 27, 2015)

Ver 2.0 (February 5, 2015)

Ver 1.0 (August 31, 2014)


Python 2.6.* or above

Python 3.3.* or above (actually, probably any version of python 3)

Click here to visit travis-ci and see the specific versions of python that praatIO is currently tested under


99% of the time you're going to want to run

from praatio import tgio
tg = tgio.openTextgrid(r"C:\Users\tim\Documents\transcript.TextGrid")

Or if you want to work with KlaatGrid files

from praatio import kgio
kg = kgio.openKlattGrid(r"C:\Users\tim\Documents\transcript.KlattGrid")

See /test for example usages


PraatIO is on pypi and can be installed or upgraded from the command-line shell with pip like so::

python -m pip install praatio --upgrade

Otherwise, to manually install, after downloading the source from github, from a command-line shell, navigate to the directory containing and type::

python install

If python is not in your path, you'll need to enter the full path e.g.::

C:\Python36\python.exe install

Citing praatIO

PraatIO is general purpose coding and doesn't need to be cited but if you would like to, it can be cited like so:

Tim Mahrt. PraatIO., 2016.


Development of PraatIO was possible thanks to NSF grant BCS 12-51343 to Jennifer Cole, José I. Hualde, and Caroline Smith and to the A*MIDEX project (n° ANR-11-IDEX-0001-02) to James Sneed German funded by the Investissements d'Avenir French Government program, managed by the French National Research Agency (ANR).