================================
Audible |version| documentation!
================================

.. Badges are SVG and cannot be embedded by the latex builder, which makes the
   pdf build warn about each one. They carry no meaning in a pdf anyway, so they
   are restricted to the html output.

.. only:: html

   .. Keep this list identical to the one in README.md, in the same order: both
      render the same set of badges and drifting apart is what let a dead Travis
      badge survive in one of them.

   .. image:: https://img.shields.io/pypi/v/audible.svg
      :target: https://pypi.org/project/audible/

   .. image:: https://img.shields.io/pypi/l/audible.svg
      :target: https://pypi.org/project/audible/

   .. image:: https://img.shields.io/pypi/pyversions/audible.svg
      :target: https://pypi.org/project/audible/

   .. image:: https://img.shields.io/pypi/status/audible.svg
      :target: https://pypi.org/project/audible/

   .. image:: https://img.shields.io/pypi/wheel/audible.svg
      :target: https://pypi.org/project/audible/

   .. image:: https://github.com/mkb79/Audible/actions/workflows/ci.yml/badge.svg
      :target: https://github.com/mkb79/Audible/actions/workflows/ci.yml

   .. image:: https://www.codefactor.io/repository/github/mkb79/audible/badge
      :target: https://www.codefactor.io/repository/github/mkb79/audible

   .. image:: https://static.pepy.tech/badge/audible/month
      :target: https://pepy.tech/project/audible

-------------------

**Audible** is a Python low-level interface to communicate with the non-publicly
`Audible <https://en.m.wikipedia.org/wiki/Audible_(service)>`_ API.
It enables Python developers to create there own Audible services. Asynchronous
communication with the Audible API is supported.

.. note::

   For a basic command line interface take a look at my
   `audible-cli <https://github.com/mkb79/audible-cli>`_ package.
   This package supports:

   - downloading audiobooks (aax/aaxc), cover, PDF and chapter file
   - export library to `csv <https://en.wikipedia.org/wiki/Comma-separated_values>`_
     files
   - get activation bytes
   - add own plugin commands

|

.. toctree::
   :maxdepth: 1
   :caption: Table of Contents

   intro/install
   intro/getting_started
   marketplaces/marketplaces
   auth/authorization
   auth/authentication
   auth/register
   misc/load_save
   misc/async
   misc/advanced
   misc/logging
   misc/external_api
   misc/examples
   misc/changelog
   modules/audible


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`