.. include:: subs.txt

.. include:: checksums.txt

Download
========

+ :ref:`dependencies`
+ :ref:`installing_from_source`
+ :ref:`installing_on_ubuntu`
+ :ref:`development_builds`

.. _dependencies:

Dependencies
------------

puddletag requires the following dependencies. Visit the respective project's page if you having trouble installing a component.

Install instructions follow below.

+   At least `Python 3.8<http://python.org>`_
+   `PyQt5<http://www.riverbankcomputing.co.uk/software/pyqt/intro>`_ for the GUI.
+   `PyParsing (≥3.0) <https://pypi.org/project/pyparsing/>`_ mtakes care of the parsing...
+   `Mutagen (≥1.45) <http://code.google.com/p/mutagen/>`_ is used as the tagging lib and...
+   `Chromaprint (≥ 0.4) <http://acoustid.org/chromaprint>`_ (optional) for AcoustID support.

.. _installing_from_source:

Installing from source
----------------------

Install the dependencies as listed above. For Debian-based distros, you can run the following as root:

.. code-block:: bash

    apt-get install python-pyqt5 python-pyparsing python-mutagen

+ Now download the source tarball |source_link|_ (SHA1 |source_sha|).
+ Unzip it.
+ You can run puddletag from that directory by typing ``./puddletag`` from the unzipped directory in your console.
+ Alternatively install it by running ``python setup.py install`` as root in the unzipped directory.
+ puddletag should appear in your Multimedia (or Sounds etc.) menu. If not run ``desktop-file-install puddletag.desktop`` as root in the unzipped directory.

.. note:: For AcoustID support in Ubuntu you will also need to **fpcalc** binary
    For Ubuntu 12.04 and later it is available in the libchromaprint-tools 
    package.

    For earlier versions and other distros please visit the 
    `AcoustID <http://acoustid.org/chromaprint>`_ page for installation
    instructions.

.. _installing_from_the_debian_package:

.. _installing_on_ubuntu:


Installing on Ubuntu
--------------------

You can install puddletag from the Software Centre in recent versions of Ubuntu.

.. _installing_on_fedora_14_and_later:

Installing on Fedora 14 and later
---------------------------------

Just run (as root):

.. code-block:: bash

   yum install puddletag

Sometimes the latest version is still in the testing repo. Then you should use (also as root:)

.. code-block:: bash

   yum --enablerepo=updates-testing install


.. _development_builds:

Development builds
------------------

Source control is done using Git. Use

.. code-block:: bash

    git clone git@github.com:puddletag/puddletag.git

to check it out. And

.. code-block:: bash

    git pull origin master

in the previously cloned directory to update it a later stage.
