1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
Metadata-Version: 1.2
Name: Mopidy-ALSAMixer
Version: 1.1.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.svg?style=flat
:target: https://pypi.python.org/pypi/Mopidy-ALSAMixer/
:alt: Latest PyPI version
.. image:: https://img.shields.io/travis/mopidy/mopidy-alsamixer/master.svg?style=flat
:target: https://travis-ci.org/mopidy/mopidy-alsamixer
:alt: Travis CI build status
.. image:: https://img.shields.io/coveralls/mopidy/mopidy-alsamixer/master.svg?style=flat
:target: https://coveralls.io/r/mopidy/mopidy-alsamixer?branch=master
:alt: Test coverage
`Mopidy <https://www.mopidy.com/>`_ 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::
pip install Mopidy-ALSAMixer
Or, if available, install the Debian/Ubuntu package from `apt.mopidy.com
<https://apt.mopidy.com/>`_.
Configuration
=============
The default configuration will probably work for most use cases.
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 <https://github.com/mopidy/mopidy-alsamixer>`_
- `Issue tracker <https://github.com/mopidy/mopidy-alsamixer/issues>`_
Credits
=======
- Original author: `Stein Magnus Jodal <https://github.com/jodal>`__
- Current maintainer: `Stein Magnus Jodal <https://github.com/jodal>`__
- `Contributors <https://github.com/mopidy/mopidy-alsamixer/graphs/contributors>`_
Changelog
=========
v1.1.1 (2018-04-01)
-------------------
- Require Mopidy >= 2.0, as we from release 1.1.0 import
``gi.repository.GstAudio``, which is incompatible with ``gobject`` which is
used by Mopidy < 2.0.
- Don't rely on all cards which use a hardware card index to be included in the
list returned by ``alsaaudio.cards()``. This can happen if an audio card is
disabled, but still use up a "card index", for example when disabling the
builtin audio card on a Raspberry Pi. (Fixes: #8)
v1.1.0 (2017-02-12)
-------------------
- Add ``alsamixer/min_volume`` and ``alsamixer/max_volume`` config values to
make Mopidy-ALSAMixer's volume scale only use a part of the underlying ALSA
volume scale. (PR: #9)
- Add ``alsamixer/volume_scale`` to allow switching between ``linear``,
``cubic``, and ``log`` scales. The default value has been changed from
``linear`` to ``cubic``, which is closer to how the human ear percieve the
volume. (Fixes: #3, PR: #9)
v1.0.3 (2014-07-31)
-------------------
- Don't crash on epoll being interrupted by the machine suspending.
v1.0.2 (2014-07-27)
-------------------
- Handle mixer controls which does not support muting. (Fixes: #1)
v1.0.1 (2014-07-21)
-------------------
- Correctly require Mopidy 0.19 instead of 0.18.
v1.0.0 (2014-07-21)
-------------------
- Initial release.
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-Python: >= 2.7, < 3
|
