..  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/>.

.. |triangle| unicode:: U+2023

Troubleshooting
===============

The player in the GUI doesn't make any sound
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Go to **Options** |triangle| **Select audio output device** and make sure the
  correct device is selected.

* Make sure the selected audio output device isn't muted and the volume is set
  correctly.

Dragging and dropping onto the GUI doesn't work
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Turn on **Options** |triangle| **Debug dragging** and try it again.  Debugging
information will appear in the message log.  Open the message log window
(**View** |triangle| **Message log**) to see it.  This won't solve the
problem, but it may help diagnose it if you include the debugging info in a
bug report (See :ref:`bug_tracker` below).

If no debugging info shows up, then Audio Tuner isn't receiving any drag and
drop signals from the operating system.  This is a known problem on Windows
with no known solution other than restarting Audio Tuner.

.. note::

    Audio Tuner will reject any drag-and-drops that attempt to move data
    rather than linking or copying it.

The export window won't overwrite an existing file
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is intended behavior.  It's a feature, not a bug.

But I told it to overwrite when the confirmation dialog popped up!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

That confirmation dialog is part of the standard file selection dialog
(possibly provided by the operating system or desktop environment), and
there's no option to disable it, so Audio Tuner just ignores it.  Sorry.

Gapless playback doesn't work
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The **rubberband** pitch correction backend can break gapless playback.  Use
the default **scaletempo2** instead.  If that doesn't fix it, there's a bigger
problem.

.. _bug_tracker:

Where is the bug tracker?
~~~~~~~~~~~~~~~~~~~~~~~~~

The bug tracker is at https://codeberg.org/bluesloth/audio_tuner/issues