Phonological CorpusTools

May 24, 2025 · View on GitHub

This document contains installation instructions for Phonological CorpusTools (PCT). For a description of available functionality, please refer to the documentation available on ReadTheDocs (http://corpustools.readthedocs.org/en/master/).

Standard installation (executable)

Windows

(NOTE: This method requires that you are running a 64-bit version of windows. You can check this by in Control Panel -> System and Security -> System.)

Download the latest executable (.exe) file from the Phonological CorpusTools release page. Double-click this file to run PCT.

Mac OS X

Download the .dmg for the latest release (e.g. Phonological.CorpusTools-.dmg from the Phonological CorpusTools releases page. Install Phonological CorpusTools by dragging the app into the Applications directory.

Linux

There is currently no executable option available for Linux operating systems. Please use the fallback installation method below to install from source.

Fallback installation

Windows, Mac OS X, or Linux

Install Python 3.3 or higher (Python 3.10 recommended) if your system does not have Python: https://www.python.org/downloads/
Download the latest source code for Phonological CorpusTools by clicking on Code > `` (see image below).

If you want to download a specific version, go to releases page and Download Source code (zip) or Source code (tar.gz) under Assets.
Unpack the source code in a directory of your choice.
Open a terminal (or command prompt for Windows) and cd into the directory.
Use the following command to install the dependencies
```
pip install -r requirements.txt
```

Windows and Mac OS X

Once all dependencies are installed, run this command to create an executable.
```
pyinstaller pct.spec
```
Now you should be able to run PCT using the icon in the dist directory.

Linux

Once all dependencies are installed, run this command to run PCT from the source code.
```
python ./bin/pct_qt_debug.py
```