Metadata-Version: 2.4
Name: discid
Version: 1.4.0
Summary: Python binding of Libdiscid
Author-email: Johannes Dewender <brainz@JonnyJD.net>, Philipp Wolfer <ph.wolfer@gmail.com>
License-Expression: LGPL-3.0-or-later
Project-URL: Documentation, https://python-discid.readthedocs.org/
Project-URL: Repository, https://github.com/metabrainz/python-discid
Project-URL: Issues, https://github.com/metabrainz/python-discid/issues
Project-URL: Changelog, https://github.com/metabrainz/python-discid/blob/master/CHANGES.rst
Project-URL: Funding, https://metabrainz.org/donate
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Sound/Audio :: CD Audio :: CD Ripping
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: COPYING.LESSER
Dynamic: license-file

Libdiscid Python bindings
-------------------------

Python-discid implements Python bindings for MusicBrainz Libdiscid. This
module supports Python 3 >= 3.10.
Libdiscid >= 0.2.2 is needed.

Libdiscid's main purpose is the calculation of an identifier of audio
discs (disc ID) to use for the `MusicBrainz database <https://musicbrainz.org>`_.

That identifier is calculated from the TOC of the disc, similar to the
freeDB CDDB identifier. Libdiscid can calculate MusicBrainz disc IDs and
freeDB disc IDs.
Additionally the MCN of the disc and ISRCs from the tracks can be extracted.

This module is a close binding that offloads all relevant data
storage and calculation to Libdiscid. On the other hand it gives a
pythonic API and uses objects and exceptions.

The official API documentation can be found at `readthedocs.org`_

For more information on Libdiscid see `libdiscid`_.

For more information about the calculation of these disc IDs see `Disc
ID Calculation`_.

Usage
~~~~~
.. code:: python

    # this will load Libdiscid
    import discid

    disc = discid.read()  # use default device
    print(f"id: {disc.id}")

See also the examples.py.

License
~~~~~~~
This module is released under the GNU Lesser General Public License
Version 3. See COPYING.LESSER for details.

Bugs
~~~~
You can submit tickets at `GitHub`_.

.. _readthedocs.org: https://python-discid.readthedocs.org/
.. _libdiscid: http://musicbrainz.org/doc/libdiscid
.. _Disc ID Calculation: http://musicbrainz.org/doc/Disc_ID_Calculation
.. _GitHub: https://github.com/metabrainz/python-discid
