source: multimedia/audioutils/pavucontrol.xml@ 9b05403

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY pavucontrol-download-http "https://freedesktop.org/software/pulseaudio/pavucontrol/pavucontrol-&pavucontrol-version;.tar.xz">
  <!ENTITY pavucontrol-download-ftp  " ">
  <!ENTITY pavucontrol-md5sum        "021ff562b18f5458a3911a40f9bd20ef">
  <!ENTITY pavucontrol-size          "164 KB">
  <!ENTITY pavucontrol-buildsize     "4.9 MB">
  <!ENTITY pavucontrol-time          "0.2 SBU">
]>

<sect1 id="pavucontrol" xreflabel="pavucontrol-&pavucontrol-version;">
  <?dbhtml filename="pavucontrol.html"?>


  <title>pavucontrol-&pavucontrol-version;</title>

  <indexterm zone="pavucontrol">
    <primary sortas="a-pavucontrol">pavucontrol</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to pavucontrol</title>

    <para>
      PulseAudio Volume Control (pavucontrol) is a simple GTK based volume
      control tool ("mixer") for the PulseAudio sound server. In contrast to
      classic mixer tools, this one allows you to control both the volume of
      hardware devices and of each playback stream separately.
    </para>

    &lfs121_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&pavucontrol-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&pavucontrol-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &pavucontrol-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &pavucontrol-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &pavucontrol-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &pavucontrol-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">pavucontrol Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="gtkmm4"/>,
      <xref linkend="json-glib"/>,
      <xref linkend="libsigc3"/>, and
      <xref linkend="pulseaudio"/>
    </para>

    <bridgehead renderas="sect3">Optional</bridgehead>
    <para role="optional">
      <xref linkend="libcanberra"/> and
      <xref linkend="lynx"/>
    </para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of pavucontrol</title>

    <para>
       Install <application>pavucontrol</application> by running the following
       commands:
    </para>

<screen><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

meson setup --prefix=/usr --buildtype=release -Dlynx=false .. &amp;&amp;
ninja</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>ninja install &amp;&amp;
mv /usr/share/doc/pavucontrol /usr/share/doc/pavucontrol-&pavucontrol-version;
</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>-Dlynx=false</parameter>: This switch disables generating the
      README file in text format. Remove this switch if you want the README
      file in text format and have <xref linkend="lynx"/> installed.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          pavucontrol
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/share/pavucontrol and /usr/share/doc/pavucontrol-&pavucontrol-version;
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="pavucontrol-prog">
        <term><command>pavucontrol</command></term>
        <listitem>
          <para>
            is a GUI configuration tool for sound settings using
            <application>pulsaudio</application>
          </para>
          <indexterm zone="pavucontrol pavucontrol-prog">
            <primary sortas="b-pavucontrol">pavucontrol</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>