Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 10, 2021

pulse-client.conf (5)


pulse-client.conf - PulseAudio client configuration file







pulse-client.conf(5)          File Formats Manual         pulse-client.conf(5)

       pulse-client.conf - PulseAudio client configuration file





       The  PulseAudio  client  library  reads configuration directives from a
       configuration  file  on  startup.  If   the   per-user   file   ~/.con-
       fig/pulse/client.conf exists, it is used, otherwise the system configu-
       ration file /etc/pulse/client.conf is used. In addition to  those  main
       files, configuration directives can also be put in files under directo-
       ries  ~/.config/pulse/client.conf.d/   and   /etc/pulse/client.conf.d/.
       Those  files  have to have the .conf file name extension, but otherwise
       the file names can be chosen freely. The files under client.conf.d  are
       processed in alphabetical order. In case the same option is set in mul-
       tiple files, the last file to set an option  overrides  earlier  files.
       The  main  client.conf file is processed first, so options set in files
       under client.conf.d override the main file.

       The configuration file is a simple collection of variable declarations.
       If  the  configuration  file parser encounters either ; or # it ignores
       the rest of the line until its end.

       For the settings that take a boolean argument the values true, yes,  on
       and 1 are equivalent, resp. false, no, off, 0.

       default-sink=  The  default sink to connect to. If specified overwrites
       the setting in the daemon. The environment variable $PULSE_SINK however
       takes precedence.

       default-source=  The  default  source to connect to. If specified over-
       writes  the  setting  in   the   daemon.   The   environment   variable
       $PULSE_SOURCE however takes precedence.

       default-server=  The default sever to connect to. The environment vari-
       able $PULSE_SERVER takes precedence.

       autospawn= Autospawn a PulseAudio daemon when needed. Takes  a  boolean
       value, defaults to yes.

       daemon-binary=  Path to the PulseAudio daemon to run when autospawning.
       Defaults to a path configured at compile time.

       extra-arguments= Extra arguments to pass to the PulseAudio daemon  when
       autospawning. Defaults to --log-target=syslog

       cookie-file=  Specify the path to the PulseAudio authentication cookie.
       Defaults to ~/.config/pulse/cookie.

       enable-shm= Enable data transfer via  POSIX  or  memfd  shared  memory.
       Takes  a boolean argument, defaults to yes. If set to no, communication
       with the server will be exclusively done through data-copy  over  sock-

       enable-memfd=.  Enable  data  transfer via memfd shared memory. Takes a
       boolean argument, defaults to yes.

       shm-size-bytes= Sets the shared memory segment  size  for  clients,  in
       bytes.  If left unspecified or is set to 0 it will default to some sys-
       tem-specific default, usually 64 MiB. Please note that usually there is
       no  need to change this value, unless you are running an OS kernel that
       does not do memory overcommit.

       auto-connect-localhost= Automatically try to connect to  localhost  via
       IP.  Enabling  this  is a potential security hole since connections are
       only authenticated one-way and a rogue server might hence fool a client
       into  sending it its private (e.g. VoIP call) data. This was enabled by
       default on PulseAudio version 0.9.21 and older. Defaults to no.

       auto-connect-display= Automatically try to connect to  the  host  X11's
       $DISPLAY variable is set to. The same security issues apply as to auto-
       connect-localhost=. Defaults to no.

       The  PulseAudio  Developers  <pulseaudio-discuss   (at)   lists   (dot)
       freedesktop  (dot)  org>;  PulseAudio is available from http://pulseau-

       See attributes(7) for descriptions of the following attributes:

       |Availability   | library/audio/pulseaudio |
       |Stability      | Pass-through volatile    |
       pulse-daemon.conf(5), pulseaudio(1)

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was  downloaded  from   http://freedesktop.org/software/pulseau-

       Further information about this software can be found on the open source
       community website at http://freedesktop.org/software/pulseaudio.

Manuals                              User                 pulse-client.conf(5)