~ubuntu-branches/ubuntu/oneiric/pulseaudio/oneiric

« back to all changes in this revision

Viewing changes to man/paplay.1

  • Committer: Bazaar Package Importer
  • Author(s): Daniel T Chen
  • Date: 2007-12-04 00:56:08 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20071204005608-y1xqvcu45g1yxtlu
Tags: 0.9.8-1ubuntu1
"Hail our new PulseAudio overlords (part two)."

* Merge from Debian unstable.
* Ubuntu-specific changes:
  - debian/control:
    + Don't build-depend on libjack0.100.0-dev or build jack module
      packages,
    + Update pulseaudio's Recommends and Suggests to accomodate
      existing promoted main packages,
    + Explicitly mention pasuspender in pulseaudio-utils's long
      description,
    + Add Vcs-Bzr URI,
    + Adhere to DebianMaintainerField;
  - debian/rules: Use multiuser for update-rc.d;
  - debian/patches/series: Retain the exclusion of
    0001-Set-ESD-socket-to-tmp-.esd-socket-to-match-up-with.patch.
* Dropped Ubuntu-specific change (absorbed into Debian source):
  debian/patches/0002-Double-esound-maximum-sample-size.patch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH paplay 1 User Manuals
 
2
.SH NAME
 
3
paplay \- Play back audio files on a PulseAudio sound server
 
4
.SH SYNOPSIS
 
5
\fBpaplay [\fIoptions\fB] \fIFILE\fB
 
6
 
 
7
paplay --help\fB
 
8
 
 
9
paplay --version\fB
 
10
\f1
 
11
.SH DESCRIPTION
 
12
\fIpaplay\f1 is a simple tool for playing back audio files on a PulseAudio sound server. It understands all audio file formats supported by \fIlibsndfile\f1.
 
13
.SH OPTIONS
 
14
.TP
 
15
\fB-h | --help\f1
 
16
Show help.
 
17
.TP
 
18
\fB--version\f1
 
19
Show version information.
 
20
.TP
 
21
\fB-v | --verbose\f1
 
22
Enable verbose operation. Dumps the current playback time to STDERR during playback.
 
23
.TP
 
24
\fB-s | --server\f1\fI=SERVER\f1
 
25
Choose the server to connect to.
 
26
.TP
 
27
\fB-d | --device\f1\fI=SINK\f1
 
28
Specify the symbolic name of the sink to play this file on.
 
29
.TP
 
30
\fB-n | --client-name\f1\fI=NAME\f1
 
31
Specify the client name \fIpaplay\f1 shall pass to the server when connecting.
 
32
.TP
 
33
\fB--stream-name\f1\fI=NAME\f1
 
34
Specify the stream name \fIpaplay\f1 shall pass to the server when creating the stream.
 
35
.TP
 
36
\fB--volume\f1\fI=VOLUME\f1
 
37
Specify the initial playback volume to use. Choose a value between 0 (silent) and 65536 (100% volume).
 
38
.TP
 
39
\fB--channel-map\f1\fI=CHANNELMAP\f1
 
40
Explicitly choose a channel map when playing back this stream. The argument should be a comma separated list of channel names: \fIfront-left\f1, \fIfront-right\f1, \fImono\f1, \fIfront-center\f1, \fIrear-left\f1, \fIrear-right\f1, \fIrear-center\f1, \fIlfe\f1, \fIfront-left-of-center\f1, \fIfront-right-of-center\f1, \fIside-left\f1, \fIside-right\f1, \fItop-center\f1, \fItop-front-center\f1, \fItop-front-left\f1, \fItop-front-right\f1, \fItop-rear-left\f1, \fItop-rear-right\f1, \fItop-rear-center\f1, or any of the 32 auxiliary channel names \fIaux0\f1 to \fIaux31\f1.
 
41
.SH LIMITATIONS
 
42
Due to a limitation in \fIlibsndfile\f1 \fIpaplay\f1 currently does not always set the correct channel mapping for playback of multichannel (i.e. surround) audio files, even if the channel mapping information is available in the audio file.
 
43
.SH AUTHORS
 
44
The PulseAudio Developers <mzchyfrnhqvb (at) 0pointer (dot) net>; PulseAudio is available from \fBhttp://pulseaudio.org/\f1
 
45
.SH SEE ALSO
 
46
\fBpulseaudio(1)\f1, \fBpacat(1)\f1