1pactl(1) General Commands Manual pactl(1)
2
6 pactl - Control a running PulseAudio sound server
7
9 pactl [options] stat
10 pactl [options] list
12 pactl [options] exit
14 pactl [options] upload-sample FILENAME [NAME]
16 pactl [options] play-sample NAME [SINK]
18 pactl [options] remove-sample NAME
20 pactl [options] move-sink-input ID SINK
22 pactl [options] move-source-input ID SOURCE
24 pactl [options] load-module NAME [ARGUMENTS ...]
26 pactl [options] unload-module ID
28 pactl [options] suspend-sink [SINK] 1|0
30 pactl [options] suspend-source [SOURCE] 1|0
32 pactl --help
34 pactl --version
36
38 pactl can be used to issue control commands to the PulseAudio sound
39 server.
40 pactl only exposes a subset of the available operations. For the full
42 set use the pacmd(1).
43
45 -h | --help
46 Show help.
47 --version
49 Show version information.
50 -s | --server=SERVER
52 Choose the server to connect to.
53 -n | --client-name=NAME
55 Specify the client name pactl shall pass to the server when con‐
56 necting.
57 stat Dump a few statistics about the PulseAudio daemon.
59 list Dump all currently loaded modules, available sinks, sources,
61 streams and clients.
62 exit Asks the PulseAudio server to terminate.
64 upload-sample FILENAME [NAME]
66 Upload a sound from the specified audio file into the sample
67 cache. The file types supported are those understood by libsnd‐
68 file. The sample in the cache is named after the audio file,
69 unless the name is explicitly specified.
70 play-sample NAME [SINK]
72 Play the specified sample from the sample cache. It is played on
73 the default sink, unless the symbolic name or the numerical
74 index of the sink to play it on is specified.
75 remove-sample NAME
77 Remove the specified sample from the sample cache.
78 move-sink-input ID SINK
80 Move the specified playback stream (identified by its numerical
81 index) to the specified sink (identified by its symbolic name or
82 numerical index).
83 move-source-output ID SOURCE
85 Move the specified recording stream (identified by its numerical
86 index) to the specified source (identified by its symbolic name
87 or numerical index).
88 load-module NAME [ARGUMENTS ...]
90 Load the specified module with the specified arguments into the
91 running sound server. Prints the numeric index of the module
92 just loaded to STDOUT. You can use it to unload the module
93 later.
94 unload-module ID
96 Unload the module instance identified by the specified numeric
97 index.
98 unload-module ID
100 Unload the module instance identified by the specified numeric
101 index.
102 suspend-sink SINK 1|0
104 Suspend or resume the specified sink (which my be specified
105 either by its symbolic name, or by its numeric index), depending
106 whether 1 (suspend) or 0 (resume) is passed as last argument.
107 Suspending a sink will pause all playback. Depending on the mod‐
108 ule implementing the sink this might have the effect that the
109 underlying device is closed, making it available for other
110 applications to use. The exact behaviour depends on the module.
111 suspend-source SOURCE 1|0
113 Suspend or resume the specified source (which my be specified
114 either by its symbolic name, or by its numeric index), depending
115 whether 1 (suspend) or 0 (resume) is passed as last argument.
116 Suspending a source will pause all capturing. Depending on the
117 module implementing the source this might have the effect that
118 the underlying device is closed, making it available for other
119 applications to use. The exact behaviour depends on the module.
120
122 The PulseAudio Developers <mzchyfrnhqvb (at) 0pointer (dot) net>;
123 PulseAudio is available from http://pulseaudio.org/
124
126 pulseaudio(1), pacmd(1)
127Manuals User pactl(1)