Metadata-Version: 2.1
Name: Mopidy-ALSAMixer
Version: 2.0.1
Summary: Mopidy extension for ALSA volume control
Home-page: https://github.com/mopidy/mopidy-alsamixer
Author: Stein Magnus Jodal
Author-email: stein.magnus@jodal.no
License: Apache License, Version 2.0
Description: ****************
Mopidy-ALSAMixer
****************
.. image:: https://img.shields.io/pypi/v/Mopidy-ALSAMixer
:target: https://pypi.python.org/pypi/Mopidy-ALSAMixer/
:alt: Latest PyPI version
.. image:: https://img.shields.io/circleci/build/gh/mopidy/mopidy-alsamixer
:target: https://circleci.com/gh/mopidy/mopidy-alsamixer
:alt: Travis CI build status
.. image:: https://img.shields.io/codecov/c/gh/mopidy/mopidy-alsamixer
:target: https://codecov.io/gh/mopidy/mopidy-alsamixer
:alt: Test coverage
`Mopidy `_ extension for ALSA volume control.
Dependencies
============
- A Linux system using ALSA for audio playback.
- ``pyalsaaudio``. Bindings for using the ALSA API from Python. The package is
available as ``python-alsaaudio`` in Debian/Ubuntu.
Installation
============
Install by running::
sudo python3 -m pip install Mopidy-AlsaMixer
See https://mopidy.com/ext/alsamixer/ for alternative installation methods.
Configuration
=============
To use Mopidy-AlsaMixer the ``audio/mixer`` configuration value must be set to
``alsamixer`` in the Mopidy configuration file::
[audio]
mixer = alsamixer
The default Mopidy-AlsaMixer configuration will probably work for most use
cases. If not, the following configuration values are available:
- ``alsamixer/card``: Which soundcard to use, if you have more than one.
Numbered from 0 and up. 0 is the default.
- ``alsamixer/control``: Which ALSA control to use. Defaults to ``Master``.
Other typical values includes ``PCM``. Run the command ``amixer scontrols``
to list available controls on your system.
- ``alsamixer/min_volume`` and ``alsamixer/max_volume``: Map the Mopidy volume
control range to a different range. Values are in the range 0-100. Use this
if the default range (0-100) is too wide, resulting in a small usable range
for Mopidy's volume control. For example try ``min_volume = 30`` and
``max_volume = 70`` to map Mopidy's volume control to the middle of ALSA's
volume range.
- ``alsamixer/volume_scale``: Either ``linear``, ``cubic``, or ``log``. The
cubic scale is the default as it is closer to how the human ear percieves
volume, and matches the volume scale used in the ``alsamixer`` program.
Example ``alsamixer`` section from the Mopidy configuration file::
[alsamixer]
card = 1
control = PCM
min_volume = 0
max_volume = 100
volume_scale = cubic
Project resources
=================
- `Source code `_
- `Issue tracker `_
- `Changelog `_
Credits
=======
- Original author: `Stein Magnus Jodal `__
- Current maintainer: `Stein Magnus Jodal `__
- `Contributors `_
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 :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.7
Provides-Extra: lint
Provides-Extra: release
Provides-Extra: test
Provides-Extra: dev