---
name: "yplay"
section: "1"
platform: "linux"
package: "yiff-server"
version: "2.14.5-7"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/yplay"
---

# yplay(1)

Y sound system sound object playing

## NAME

yplay - Y sound system sound object playing

## SYNTAX

**yplay** \[*options*\] \<*file1*\> \[*file2*\] ...

## DESCRIPTION

Instructs the Y server to start playing the specified sound objects on file data on the Y server's VFS (virtual file system).

## SOUND FILES

Specify one or more paths to sound object files on the Y server's VFS (the Virtual File System of the computer that the Y server is running on).

If the specified path to the sound object file data is not an absolute path then the sound object file will be searched through the Y server's defined sound paths.

To interrupt the play at any time, press ctrl+c.

## OPTIONS

- **-m**

  Allow change Audio mode as needed (may cause sound objects played by other applications to be killed).

- **-s** \<*samplerate*\>

  Applied sample rate in Hz.

- **-r** \<*n*\>

  Repeat *n* times (-1 for infinate).

- **-vol** \<*left*\> \<*right*\>

  Specify volume coefficients, valid values are from 0.0 to 1.0 inclusive.

- **-v**

  Print verbose status messages.

- **--recorder** \<*address*:*port*\>

  Specify which Y server to connect to.

- **--help**

  Print help screen and exit.

## RETURN VALUE

- **0**

  Success.

- **1**

  General error.

- **2**

  Cannot connect to Y server error.

- **3**

  Systems error.

## ENVIRONMENT VARIABLES

- **RECORDER**

  Specifies the Y server \<*address*:*port*\> to connect to. This is a fall back if the argument **--recorder** is not specified.

## EXAMPLES

To play the sound object file /usr/share/sounds/info.wav on the Y server's machine, type:

\# yplay /usr/share/sounds.info.wav

To play the same sound object file infinatly and verbosly, type:

\# yplay -r -1 -v /usr/share/sounds.info.wav

To allow yplay to change the Audio values of the Y server to best match the given sound object file data, type:

\# yplay -m /usr/share/sounds.info.wav

## AUTHORS

http://wolfpack.twu.net/contacts.html

## SEE ALSO

- YIFF home page

  http://wolfpack.twu.net/YIFF/

yiff(1) yaudiocd(1) [yhost(1)](/yhost/1.md) [ymixer(1)](/ymixer/1.md) [yrecinfo(1)](/yrecinfo/1.md) [yshutdown(1)](/yshutdown/1.md) [yset(1)](/yset/1.md)