Metadata-Version: 2.0
Name: Mopidy-NAD
Version: 1.0.0
Summary: Mopidy extension for controlling volume on a NAD amplifier
Home-page: https://github.com/mopidy/mopidy-nad
Author: Stein Magnus Jodal
Author-email: stein.magnus@jodal.no
License: Apache License, Version 2.0
Platform: UNKNOWN
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Dist: setuptools
Requires-Dist: Mopidy (>=0.14)
Requires-Dist: Pykka (>=1.1)
Requires-Dist: pyserial

**********
Mopidy-NAD
**********

.. image:: https://pypip.in/v/Mopidy-NAD/badge.png
    :target: https://crate.io/packages/Mopidy-NAD/
    :alt: Latest PyPI version

.. image:: https://pypip.in/d/Mopidy-NAD/badge.png
    :target: https://crate.io/packages/Mopidy-NAD/
    :alt: Number of PyPI downloads

.. image:: https://travis-ci.org/mopidy/mopidy-nad.png?branch=master
    :target: https://travis-ci.org/mopidy/mopidy-nad
    :alt: Travis CI build status

.. image:: https://coveralls.io/repos/mopidy/mopidy-nad/badge.png?branch=master
   :target: https://coveralls.io/r/mopidy/mopidy-nad?branch=master
   :alt: Test coverage

`Mopidy <http://www.mopidy.com/>`_ extension for controlling volume using an
external NAD amplifier. Developed and tested with a NAD C355BEE.


Installation
============

Install by running::

    sudo pip install Mopidy-NAD

Or, if available, install the Debian/Ubuntu package from `apt.mopidy.com
<http://apt.mopidy.com/>`_.


Configuration
=============

The Mopidy-NAD extension is enabled by default. To disable it, add the
following to ``mopidy.conf``::

    [nad]
    enabled = false

The NAD amplifier must be connected to the machine running Mopidy using a
serial cable.

To use the NAD amplifier ot control volume, set the ``audio/mixer`` config
value in ``mopidy.conf`` to ``nadmixer``. You probably also needs to add some
properties to the ``audio/mixer`` config value.

Supported properties includes:

- ``port``: The serial device to use, defaults to ``/dev/ttyUSB0``. This must
  be set correctly for the mixer to work.

- ``source``: The source that should be selected on the amplifier, like
  ``aux``, ``disc``, ``tape``, ``tuner``, etc. Leave unset if you don't want
  the mixer to change it for you.

- ``speakers-a``: Set to ``on`` or ``off`` if you want the mixer to make sure
  that speaker set A is turned on or off. Leave unset if you don't want the
  mixer to change it for you.

- ``speakers-b``: See ``speakers-a``.

Configuration examples::

    # Minimum configuration, if the amplifier is available at /dev/ttyUSB0
    [audio]
    mixer = nadmixer

    # Minimum configuration, if the amplifier is available elsewhere
    [audio]
    mixer = nadmixer port=/dev/ttyUSB3

    # Full configuration
    [audio]
    mixer = nadmixer port=/dev/ttyUSB0 source=aux speakers-a=on speakers-b=off


Project resources
=================

- `Source code <https://github.com/mopidy/mopidy-nad>`_
- `Issue tracker <https://github.com/mopidy/mopidy-nad/issues>`_
- `Download development snapshot <https://github.com/mopidy/mopidy-nad/tarball/master#egg=Mopidy-NAD-dev>`_


Changelog
=========

v1.0 (2013-10-08)
-----------------

- Update to match the ``cookiecutter-mopidy-ext`` project template.

v0.3 (2013-04-16)
-----------------

- Include ``README.rst`` and ``LICENSE`` in PyPI package.

v0.2 (2013-04-16)
-----------------

- Add missing ``create_track()`` helper function.

v0.1 (2013-04-16)
-----------------

- Extracted extension from Mopidy core.


