Metadata-Version: 2.4
Name: audio-tuner
Version: 0.9.1
Summary: Analyze the tuning of audio recordings
Project-URL: Homepage, https://codeberg.org/bluesloth/audio_tuner
Project-URL: Repository, https://codeberg.org/bluesloth/audio_tuner.git
Project-URL: Issues, https://codeberg.org/bluesloth/audio_tuner/issues
Project-URL: Documentation, https://audio-tuner.readthedocs.io/en/latest/
Author-email: Jessie Blue Cassell <bluesloth600@gmail.com>
License-File: COPYING
Keywords: audio,music,tuning
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: namedpipe
Requires-Dist: numpy
Requires-Dist: platformdirs
Requires-Dist: python-mpv
Description-Content-Type: text/x-rst

Audio Tuner
===========

A tool for musicians that analyzes and corrects the pitch of recorded audio.

This package provides the python library and a simple CLI front end.  A GUI
front end is also available in the **audio-tuner-gui** package that can play
and export audio with the pitch corrected.

Motivation
~~~~~~~~~~

A surprisingly high proportion of recorded music doesn't conform to any
standard tuning system.  You expect an A4 to be 440 Hz, but when you try to
play along you realize it's not.  Audio Tuner is a tool for measuring the
frequencies in an audio recording so it can be corrected if necessary.  It's
designed to be convenient enough to use that you can do it with a musical
instrument strapped to you.

The primary use case is to correct the tuning of your favorite songs so you
can practice playing an instrument by playing along with them, but it can be
used in any situation where you need to analyze and correct the pitch of a
recording.

What it's not
~~~~~~~~~~~~~

Audio Tuner is not autotune.  It pitch corrects entire songs, not individual
notes.

CLI Usage
~~~~~~~~~

Type 'tuner' at a shell prompt followed by the name(s) of the file(s) you
want to analyze.

For more detailed usage information, run:

.. code:: bash

    tuner --help

Free as in Freedom
~~~~~~~~~~~~~~~~~~

Audio Tuner is licensed under the `GNU General Public License`_ version 3 or
later.

.. _GNU General Public License: https://gnu.org/licenses/gpl.html

See
`What is Free Software? <https://www.gnu.org/philosophy/free-sw.html>`_
and
`Copyleft: Pragmatic Idealism
<https://www.gnu.org/philosophy/pragmatic.html>`_.

Versioning
~~~~~~~~~~

Audio Tuner attempts to use `Semantic Versioning`_, but with `PEP 440`_
compatible version numbers.

New versions of the base Audio Tuner package and Audio Tuner GUI are released
at the same time with the same version numbers.  The API is already reasonably
stable, but of course nothing's guaranteed until it reaches version 1.0.0.  

.. _Semantic Versioning: https://semver.org
.. _PEP 440: https://peps.python.org/pep-0440/

Dependencies
~~~~~~~~~~~~

Audio Tuner requires **Python version 3.11 or higher** and **libmpv2**.  In
addition, The following dependencies will be installed automatically by pip or
pipx:

* `numpy`_
* `python-mpv`_
* `namedpipe`_
* `platformdirs`_

.. _numpy: https://www.numpy.org
.. _python-mpv: https://github.com/jaseg/python-mpv
.. _namedpipe: https://github.com/python-ffmpegio/python-namedpipe
.. _platformdirs: https://github.com/platformdirs/platformdirs

Audio Tuner can be configured to use **ffmpeg** and **ffprobe** instead of
libmpv2, but this is not recommended if you install the GUI.

See Also
~~~~~~~~

See the `html documentation`_ for more information and detailed installation
instructions.

.. _html documentation: https://audio-tuner.readthedocs.io/en/latest/
