---
title: "Praat remote control"
author: "Oliver Ehmer"
date: "`r Sys.Date()`"
output:
  rmarkdown::html_vignette:
    toc: true
    toc_float: false
    toc_depth: 2
vignette: >
  %\VignetteIndexEntry{Praat remote control}
  %\VignetteEngine{knitr::rmarkdown}
  \usepackage[utf8]{inputenc}
---

# English

The functions `transcripts_openin_praat()`, `search_openresult_inpraat()` and `search_searchandopen_inpraat()` open a transcript in the TextGrid editor of *Praat*, with its sound and a selected time range. They remote control *Praat* with a *Praat* script.

## The path to Praat

*act* looks for *Praat* in the usual places when it is loaded (`/Applications/Praat.app` on macOS, the program folders on Windows, the PATH on Linux). Elsewhere, set the path once:

```r
options(act.path.praat = "/Applications/Praat.app")      # macOS
options(act.path.praat = "C:/Program Files/Praat.exe")    # Windows
```

*Praat* (version 6.1 or later) receives the script through its own command line option `--send`. If *Praat* is not running, it is started. Nothing else needs to be installed; the separate program *sendpraat* is no longer used.

# Deutsch

Die Funktionen `transcripts_openin_praat()`, `search_openresult_inpraat()` und `search_searchandopen_inpraat()` öffnen ein Transkript im TextGrid-Editor von *Praat*, mit Ton und einem ausgewählten Zeitabschnitt. Sie steuern *Praat* mit einem *Praat*-Skript fern.

## Der Pfad zu Praat

*act* sucht *Praat* beim Laden an den üblichen Orten (`/Applications/Praat.app` unter macOS, die Programmordner unter Windows, den PATH unter Linux). Liegt es woanders, setzen Sie den Pfad einmal:

```r
options(act.path.praat = "/Applications/Praat.app")      # macOS
options(act.path.praat = "C:/Program Files/Praat.exe")    # Windows
```

*Praat* (ab Version 6.1) erhält das Skript über seine eigene Kommandozeilenoption `--send`. Läuft *Praat* nicht, wird es gestartet. Es muss nichts weiter installiert werden; das separate Programm *sendpraat* wird nicht mehr benutzt.