> For the complete documentation index, see [llms.txt](https://liri-resources-hub.gitbook.io/svt/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://liri-resources-hub.gitbook.io/svt/general-info/praat-script-and-plugin-guide.md).

# Praat Script & Plugin Guide

This page provides some concise information to efficiently convey the essential tips of using Praat scripts (functions) and plugins provided here.

A **Praat script** is a single file that you run when needed. It is great for quick tasks and it saves your time by automating your repeatedly used workflow. On there other hand, a **Praat plugin** is a collection of scripts that adds new features to Praat’s menus. It stays available every time you open Praat.

## Praat Scripts

<figure><img src="/files/RLpL6jnJOh5XVNNrD1xq" alt="" width="165"><figcaption></figcaption></figure>

To open a downloaded script, simply go to *Praat -> Open Praat script*, and choose the script to open. An individual window of the selected script will open.

<figure><img src="/files/pSs1yYLWPYXujhJhrSwH" alt="" width="128"><figcaption></figcaption></figure>

Click *Run -> Run* (or press `cmd+R`/`ctrl+R`) to run the script.

**Note**: Some scripts require one or multiple Praat object(s) selected before running. This can be usually hinted at the last paragraph of the desctiption of the script in this documentation.

## Praat Plugins

A plugin normally contains multiple files and scripts, in a folder with the name starts with `plugin_`, which is normally put in the Praat preference folder. Follow the installation guide that takes PresenterPro as an example to make sure it's correctly installed.&#x20;

### Installation

* Method 1 (recommended): Copy the directory `./plugin_PresenterPro` into the [Praat preferences directory](https://www.fon.hum.uva.nl/praat/manual/preferences_folder.html): \
  Assuming you're user `liri`:, \
  on Windows: `C:\Users\liri\Praat\`; \
  on MacOS: `/Users/liri/Library/Preferences/Praat Prefs/`; \
  on Linux: `/home/liri/.praat-dir/`.\
  Then reopen Praat, PresenterPro automatically appears in Praat under ‘New > PresenterPro’, in Praat Objects window.
* Method 2: Execute the script `setup.praat` that’s inside the directory. \
  **Note**: if using this method, the plugin folder should not be moved somewhere else after executing the script, otherwise it couldn’t be found next time. Therefore highly recommend to use method 1.

<figure><img src="/files/GVbPWs26XbGtPIsMFnpj" alt="" width="375"><figcaption></figcaption></figure>