..  This file is part of Audio Tuner.

    Copyright 2025, 2026 Jessie Blue Cassell <bluesloth600@gmail.com>

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.

GUI Quick Start
===============

.. figure:: _static/Screenshot_main.png

    The main GUI, using the Qt port of the Adwaita-dark theme and the Tango
    icon theme.

Start the GUI by running ``tuner-gui``.

Select some audio files in the :ref:`file_selector_panel` (bottom left),
either by double clicking or by highlighting them and pressing :kbd:`Enter`.

You can also select files for analysis by dragging and dropping them from a
file manager anywhere onto the Audio Tuner window.  If you drop a directory
instead, the :ref:`file_selector_panel` will go to that directory.

When the analysis is finished, the files will appear in the
:ref:`analyzed_audio_panel` (bottom right).  Select one and the results of the
analysis will appear in the :ref:`display`.

If the needles aren't centered, the music's pitch is off.  Drag the slider in
the :ref:`quick_tuner` to adjust it.

You can also press :kbd:`F2` (or click on the leftmost button on the toolbar)
to switch to the :ref:`option_panel` and play with some options there.  Push
the :guilabel:`Apply to selected` button to apply them.

Push the **play** button on the :ref:`toolbar` to start playback.  If it still
doesn't sound in tune enough, you can keep adjusting the pitch while it's
playing.

.. hint::

    The :guilabel:`Correction` column in the display gives you the exact
    correction factor needed to center it's associated needle.  You can also
    watch the "ghost needles" that appear when you adjust the pitch correction
    to see when they reach the center.

.. hint::

    Most songs have enough variation in tuning that you can't perfectly center
    all the needles at the same time, but don't worry about it too much.  It
    doesn't have to be perfect, and your ears have the final say.  If it
    sounds good enough, it is good enough.