# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://liri-resources-hub.gitbook.io/svt/general-info/praat-script-and-plugin-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
