pactl(1)
NAME
pactl - Control a running PulseAudio sound server
SYNOPSIS
pactl [options] COMMAND [ARGS ...] pactl --help pactl --version
DESCRIPTION
pactl can be used to issue control commands to the PulseAudio sound server. pactl only exposes a subset of the available operations. For the full set use the pacmd(1).
OPTIONS
-h | --help
Show help.
--version
Show version information.
-s | --server=SERVER
Choose the server to connect to.
-n | --client-name=NAME
Specify the client name pactl shall pass to the server when
connecting.
COMMANDS
stat Dump a few statistics about the memory usage of the PulseAudio
daemon.
info Dump some info about the PulseAudio daemon.
list [short] [TYPE]
Dump all currently loaded modules, available sinks, sources,
streams, etc. TYPE must be one of: modules, sinks, sources,
sink-inputs, source-outputs, clients, samples, cards. If not
specified, all info is listed. If short is given, output is in a
tabular format, for easy parsing by scripts.
exit Asks the PulseAudio server to terminate.
upload-sample FILENAME [NAME]
Upload a sound from the specified audio file into the sample
cache. The file types supported are those understood by
libsndfile. The sample in the cache is named after the audio
file, unless the name is explicitly specified.
play-sample NAME [SINK]
Play the specified sample from the sample cache. It is played on
the default sink, unless the symbolic name or the numerical
index of the sink to play it on is specified.
remove-sample NAME
Remove the specified sample from the sample cache.
load-module NAME [ARGUMENTS ...]
Load the specified module with the specified arguments into the
running sound server. Prints the numeric index of the module
just loaded to STDOUT. You can use it to unload the module
later.
unload-module ID|NAME
Unload the module instance identified by the specified numeric
index or unload all modules by the specified name.
move-sink-input ID SINK
Move the specified playback stream (identified by its numerical
index) to the specified sink (identified by its symbolic name or
numerical index).
move-source-output ID SOURCE
Move the specified recording stream (identified by its numerical
index) to the specified source (identified by its symbolic name
or numerical index).
suspend-sink SINK 1|0
Suspend or resume the specified sink (which my be specified
either by its symbolic name, or by its numeric index), depending
whether 1 (suspend) or 0 (resume) is passed as last argument.
Suspending a sink will pause all playback. Depending on the
module implementing the sink this might have the effect that the
underlying device is closed, making it available for other
applications to use. The exact behaviour depends on the module.
suspend-source SOURCE 1|0
Suspend or resume the specified source (which my be specified
either by its symbolic name, or by its numeric index), depending
whether 1 (suspend) or 0 (resume) is passed as last argument.
Suspending a source will pause all capturing. Depending on the
module implementing the source this might have the effect that
the underlying device is closed, making it available for other
applications to use. The exact behaviour depends on the module.
set-card-profile CARD PROFILE
Set the specified card (identified by its symbolic name or
numerical index) to the specified profile (identified by its
symbolic name).
set-default-sink SINK
Make the specified sink (identified by its symbolic name) the
default sink.
set-sink-port SINK PORT
Set the specified sink (identified by its symbolic name or
numerical index) to the specified port (identified by its
symbolic name).
set-default-source SOURCE
Make the specified source (identified by its symbolic name) the
default source.
set-source-port SOURCE PORT
Set the specified source (identified by its symbolic name or
numerical index) to the specified port (identified by its
symbolic name).
set-port-latency-offset CARD PORT OFFSET
Set a latency offset to a specified port (identified by its
symbolic name) that belongs to a card (identified by its
symbolic name or numerical index). OFFSET is a number which
represents the latency offset in microseconds
set-sink-volume SINK VOLUME [VOLUME ...]
Set the volume of the specified sink (identified by its symbolic
name or numerical index). VOLUME can be specified as an integer
(e.g. 2000, 16384), a linear factor (e.g. 0.4, 1.100), a
percentage (e.g. 10%, 100%) or a decibel value (e.g. 0dB, 20dB).
If the volume specification start with a + or - the volume
adjustment will be relative to the current sink volume. A single
volume value affects all channels; if multiple volume values are
given their number has to match the sink's number of channels.
set-source-volume SOURCE VOLUME [VOLUME ...]
Set the volume of the specified source (identified by its
symbolic name or numerical index). VOLUME can be specified as an
integer (e.g. 2000, 16384), a linear factor (e.g. 0.4, 1.100), a
percentage (e.g. 10%, 100%) or a decibel value (e.g. 0dB, 20dB).
If the volume specification start with a + or - the volume
adjustment will be relative to the current source volume. A
single volume value affects all channels; if multiple volume
values are given their number has to match the source's number
of channels.
set-sink-input-volume INPUT VOLUME [VOLUME ...]
Set the volume of the specified sink input (identified by its
numerical index). VOLUME can be specified as an integer (e.g.
2000, 16384), a linear factor (e.g. 0.4, 1.100), a percentage
(e.g. 10%, 100%) or a decibel value (e.g. 0dB, 20dB). If the
volume specification start with a + or - the volume adjustment
will be relative to the current sink input volume. A single
volume value affects all channels; if multiple volume values are
given their number has to match the sink input's number of
channels.
set-source-output-volume OUTPUT VOLUME [VOLUME ...]
Set the volume of the specified source output (identified by its
numerical index). VOLUME can be specified as an integer (e.g.
2000, 16384), a linear factor (e.g. 0.4, 1.100), a percentage
(e.g. 10%, 100%) or a decibel value (e.g. 0dB, 20dB). If the
volume specification start with a + or - the volume adjustment
will be relative to the current source output volume. A single
volume value affects all channels; if multiple volume values are
given their number has to match the source output's number of
channels.
set-sink-mute SINK 1|0|toggle
Set the mute status of the specified sink (identified by its
symbolic name or numerical index).
set-source-mute SOURCE 1|0|toggle
Set the mute status of the specified source (identified by its
symbolic name or numerical index).
set-sink-input-mute INPUT 1|0|toggle
Set the mute status of the specified sink input (identified by
its numerical index).
set-source-output-mute INPUT 1|0|toggle
Set the mute status of the specified source output (identified
by its numerical index).
set-sink-formats SINK FORMATS
Set the supported formats of the specified sink (identified by
its numerical index) if supported by the sink. FORMATS is
specified as a semi-colon (;) separated list of formats in the
form 'encoding[, key1=value1, key2=value2, ...]' (for example,
AC3 at 32000, 44100 and 48000 Hz would be specified as
'ac3-iec61937, format.rate = "[ 32000, 44100, 48000 ]"').
subscribe
Subscribe to events, pactl does not exit by itself, but keeps
waiting for new events.
AUTHORS
The PulseAudio Developers <pulseaudio-discuss (at) lists (dot) freedesktop (dot) org>; PulseAudio is available from http://pulseaudio.org/
SEE ALSO
pulseaudio(1), pacmd(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
