Mopidy-ALSAMixer-2.0.0/ 0000775 0001750 0001750 00000000000 13577725111 014714 5 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/.circleci/ 0000775 0001750 0001750 00000000000 13577725111 016547 5 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/.circleci/config.yml 0000664 0001750 0001750 00000002065 13577724336 020552 0 ustar jodal jodal 0000000 0000000 version: 2.1
orbs:
codecov: codecov/codecov@1.0.5
workflows:
version: 2
test:
jobs:
- py38
- py37
- black
- check-manifest
- flake8
jobs:
py38: &test-template
docker:
- image: mopidy/ci-python:3.8
steps:
- checkout
- restore_cache:
name: Restoring tox cache
key: tox-v1-{{ .Environment.CIRCLE_JOB }}-{{ checksum "setup.cfg" }}
- run:
name: Run tests
command: |
tox -e $CIRCLE_JOB -- \
--junit-xml=test-results/pytest/results.xml \
--cov-report=xml
- save_cache:
name: Saving tox cache
key: tox-v1-{{ .Environment.CIRCLE_JOB }}-{{ checksum "setup.cfg" }}
paths:
- ./.tox
- ~/.cache/pip
- codecov/upload:
file: coverage.xml
- store_test_results:
path: test-results
py37:
<<: *test-template
docker:
- image: mopidy/ci-python:3.7
black: *test-template
check-manifest: *test-template
flake8: *test-template
Mopidy-ALSAMixer-2.0.0/CHANGELOG.rst 0000664 0001750 0001750 00000003114 13577724567 016752 0 ustar jodal jodal 0000000 0000000 *********
Changelog
*********
v2.0.0 (2019-12-22)
===================
- Depend on final release of Mopidy 3.0.0.
v2.0.0rc1 (2019-11-11)
======================
- Require Mopidy >= 3.0.0a3.
- Require Python >= 3.7. No major changes required.
- Update project setup.
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.
Mopidy-ALSAMixer-2.0.0/LICENSE 0000664 0001750 0001750 00000026135 13577724336 015740 0 ustar jodal jodal 0000000 0000000
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License. Mopidy-ALSAMixer-2.0.0/MANIFEST.in 0000664 0001750 0001750 00000000412 13577724336 016457 0 ustar jodal jodal 0000000 0000000 include *.py
include *.rst
include .mailmap
include LICENSE
include MANIFEST.in
include pyproject.toml
include tox.ini
recursive-include .circleci *
recursive-include .github *
include mopidy_*/ext.conf
recursive-include tests *.py
recursive-include tests/data *
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/ 0000775 0001750 0001750 00000000000 13577725111 021454 5 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/PKG-INFO 0000664 0001750 0001750 00000010270 13577725111 022551 0 ustar jodal jodal 0000000 0000000 Metadata-Version: 2.1
Name: Mopidy-ALSAMixer
Version: 2.0.0
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
=============
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 `_
- `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: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.7
Provides-Extra: lint
Provides-Extra: release
Provides-Extra: test
Provides-Extra: dev
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/SOURCES.txt 0000664 0001750 0001750 00000001023 13577725111 023334 0 ustar jodal jodal 0000000 0000000 CHANGELOG.rst
LICENSE
MANIFEST.in
README.rst
pyproject.toml
setup.cfg
setup.py
tox.ini
.circleci/config.yml
Mopidy_ALSAMixer.egg-info/PKG-INFO
Mopidy_ALSAMixer.egg-info/SOURCES.txt
Mopidy_ALSAMixer.egg-info/dependency_links.txt
Mopidy_ALSAMixer.egg-info/entry_points.txt
Mopidy_ALSAMixer.egg-info/not-zip-safe
Mopidy_ALSAMixer.egg-info/requires.txt
Mopidy_ALSAMixer.egg-info/top_level.txt
mopidy_alsamixer/__init__.py
mopidy_alsamixer/ext.conf
mopidy_alsamixer/mixer.py
tests/__init__.py
tests/test_extension.py
tests/test_mixer.py Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/dependency_links.txt 0000664 0001750 0001750 00000000001 13577725111 025522 0 ustar jodal jodal 0000000 0000000
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/entry_points.txt 0000664 0001750 0001750 00000000065 13577725111 024753 0 ustar jodal jodal 0000000 0000000 [mopidy.ext]
alsamixer = mopidy_alsamixer:Extension
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/not-zip-safe 0000664 0001750 0001750 00000000001 13577724500 023703 0 ustar jodal jodal 0000000 0000000
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/requires.txt 0000664 0001750 0001750 00000000460 13577725111 024054 0 ustar jodal jodal 0000000 0000000 Mopidy>=3.0.0
Pykka>=2.0.1
setuptools
pyalsaaudio
[dev]
black
check-manifest
flake8
flake8-bugbear
flake8-import-order
isort[pyproject]
twine
wheel
pytest
pytest-cov
[lint]
black
check-manifest
flake8
flake8-bugbear
flake8-import-order
isort[pyproject]
[release]
twine
wheel
[test]
pytest
pytest-cov
Mopidy-ALSAMixer-2.0.0/Mopidy_ALSAMixer.egg-info/top_level.txt 0000664 0001750 0001750 00000000021 13577725111 024177 0 ustar jodal jodal 0000000 0000000 mopidy_alsamixer
Mopidy-ALSAMixer-2.0.0/PKG-INFO 0000664 0001750 0001750 00000010270 13577725111 016011 0 ustar jodal jodal 0000000 0000000 Metadata-Version: 2.1
Name: Mopidy-ALSAMixer
Version: 2.0.0
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
=============
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 `_
- `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: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.7
Provides-Extra: lint
Provides-Extra: release
Provides-Extra: test
Provides-Extra: dev
Mopidy-ALSAMixer-2.0.0/README.rst 0000664 0001750 0001750 00000005310 13577724455 016414 0 ustar jodal jodal 0000000 0000000 ****************
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
=============
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 `_
- `Issue tracker `_
- `Changelog `_
Credits
=======
- Original author: `Stein Magnus Jodal `__
- Current maintainer: `Stein Magnus Jodal `__
- `Contributors `_
Mopidy-ALSAMixer-2.0.0/mopidy_alsamixer/ 0000775 0001750 0001750 00000000000 13577725111 020262 5 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/mopidy_alsamixer/__init__.py 0000664 0001750 0001750 00000001654 13577724336 022411 0 ustar jodal jodal 0000000 0000000 import pathlib
import pkg_resources
from mopidy import config, ext
__version__ = pkg_resources.get_distribution("Mopidy-ALSAMixer").version
class Extension(ext.Extension):
dist_name = "Mopidy-ALSAMixer"
ext_name = "alsamixer"
version = __version__
def get_default_config(self):
return config.read(pathlib.Path(__file__).parent / "ext.conf")
def get_config_schema(self):
schema = super().get_config_schema()
schema["card"] = config.Integer(minimum=0)
schema["control"] = config.String()
schema["min_volume"] = config.Integer(minimum=0, maximum=100)
schema["max_volume"] = config.Integer(minimum=0, maximum=100)
schema["volume_scale"] = config.String(
choices=("linear", "cubic", "log")
)
return schema
def setup(self, registry):
from mopidy_alsamixer.mixer import AlsaMixer
registry.add("mixer", AlsaMixer)
Mopidy-ALSAMixer-2.0.0/mopidy_alsamixer/ext.conf 0000664 0001750 0001750 00000000152 13577724336 021737 0 ustar jodal jodal 0000000 0000000 [alsamixer]
enabled = true
card = 0
control = Master
min_volume = 0
max_volume = 100
volume_scale = cubic
Mopidy-ALSAMixer-2.0.0/mopidy_alsamixer/mixer.py 0000664 0001750 0001750 00000015233 13577724336 021774 0 ustar jodal jodal 0000000 0000000 import logging
import math
import select
import threading
import alsaaudio
import gi
import pykka
gi.require_version("GstAudio", "1.0") # noqa
from gi.repository import GstAudio # isort:skip
from mopidy import exceptions, mixer # isort:skip
logger = logging.getLogger(__name__)
class AlsaMixer(pykka.ThreadingActor, mixer.Mixer):
name = "alsamixer"
def __init__(self, config):
super().__init__()
self.config = config
self.cardindex = self.config["alsamixer"]["card"]
self.control = self.config["alsamixer"]["control"]
self.min_volume = self.config["alsamixer"]["min_volume"]
self.max_volume = self.config["alsamixer"]["max_volume"]
self.volume_scale = self.config["alsamixer"]["volume_scale"]
known_cards = alsaaudio.cards()
try:
known_controls = alsaaudio.mixers(self.cardindex)
except alsaaudio.ALSAAudioError:
raise exceptions.MixerError(
f"Could not find ALSA soundcard with index {self.cardindex:d}. "
"Known soundcards include: "
", ".join(known_cards)
)
if self.control not in known_controls:
raise exceptions.MixerError(
f"Could not find ALSA mixer control {self.control} on "
f"card {self.cardindex:d}. "
f"Known mixers on card {self.cardindex:d} include: "
", ".join(known_controls)
)
self._last_volume = None
self._last_mute = None
logger.info(
f"Mixing using ALSA, card {self.cardindex:d}, "
f"mixer control {self.control!r}."
)
def on_start(self):
self._observer = AlsaMixerObserver(
cardindex=self.cardindex,
control=self.control,
callback=self.actor_ref.proxy().trigger_events_for_changed_values,
)
self._observer.start()
@property
def _mixer(self):
# The mixer must be recreated every time it is used to be able to
# observe volume/mute changes done by other applications.
return alsaaudio.Mixer(cardindex=self.cardindex, control=self.control)
def get_volume(self):
channels = self._mixer.getvolume()
if not channels:
return None
elif channels.count(channels[0]) == len(channels):
return self.mixer_volume_to_volume(channels[0])
else:
# Not all channels have the same volume
return None
def set_volume(self, volume):
self._mixer.setvolume(self.volume_to_mixer_volume(volume))
return True
def mixer_volume_to_volume(self, mixer_volume):
volume = mixer_volume
if self.volume_scale == "cubic":
volume = (
GstAudio.StreamVolume.convert_volume(
GstAudio.StreamVolumeFormat.CUBIC,
GstAudio.StreamVolumeFormat.LINEAR,
volume / 100.0,
)
* 100.0
)
elif self.volume_scale == "log":
# Uses our own formula rather than GstAudio.StreamVolume.
# convert_volume(GstAudio.StreamVolumeFormat.LINEAR,
# GstAudio.StreamVolumeFormat.DB, mixer_volume / 100.0)
# as the result is a DB value, which we can't work with as
# self._mixer provides a percentage.
volume = math.pow(10, volume / 50.0)
volume = (
(volume - self.min_volume)
* 100.0
/ (self.max_volume - self.min_volume)
)
return int(volume)
def volume_to_mixer_volume(self, volume):
mixer_volume = (
self.min_volume
+ volume * (self.max_volume - self.min_volume) / 100.0
)
if self.volume_scale == "cubic":
mixer_volume = (
GstAudio.StreamVolume.convert_volume(
GstAudio.StreamVolumeFormat.LINEAR,
GstAudio.StreamVolumeFormat.CUBIC,
mixer_volume / 100.0,
)
* 100.0
)
elif self.volume_scale == "log":
# Uses our own formula rather than GstAudio.StreamVolume.
# convert_volume(GstAudio.StreamVolumeFormat.LINEAR,
# GstAudio.StreamVolumeFormat.DB, mixer_volume / 100.0)
# as the result is a DB value, which we can't work with as
# self._mixer wants a percentage.
mixer_volume = 50 * math.log10(mixer_volume)
return int(mixer_volume)
def get_mute(self):
try:
channels_muted = self._mixer.getmute()
except alsaaudio.ALSAAudioError as exc:
logger.debug(f"Getting mute state failed: {exc}")
return None
if all(channels_muted):
return True
elif not any(channels_muted):
return False
else:
# Not all channels have the same mute state
return None
def set_mute(self, mute):
try:
self._mixer.setmute(int(mute))
return True
except alsaaudio.ALSAAudioError as exc:
logger.debug(f"Setting mute state failed: {exc}")
return False
def trigger_events_for_changed_values(self):
old_volume, self._last_volume = self._last_volume, self.get_volume()
old_mute, self._last_mute = self._last_mute, self.get_mute()
if old_volume != self._last_volume:
self.trigger_volume_changed(self._last_volume)
if old_mute != self._last_mute:
self.trigger_mute_changed(self._last_mute)
class AlsaMixerObserver(threading.Thread):
daemon = True
name = "AlsaMixerObserver"
def __init__(self, cardindex, control, callback=None):
super().__init__()
self.running = True
# Keep the mixer instance alive for the descriptors to work
self.mixer = alsaaudio.Mixer(cardindex=cardindex, control=control)
descriptors = self.mixer.polldescriptors()
assert len(descriptors) == 1
self.fd = descriptors[0][0]
self.event_mask = descriptors[0][1]
self.callback = callback
def stop(self):
self.running = False
def run(self):
poller = select.epoll()
poller.register(self.fd, self.event_mask | select.EPOLLET)
while self.running:
try:
events = poller.poll(timeout=1)
if events and self.callback is not None:
self.callback()
except OSError as exc:
# poller.poll() will raise an IOError because of the
# interrupted system call when suspending the machine.
logger.debug(f"Ignored IO error: {exc}")
Mopidy-ALSAMixer-2.0.0/pyproject.toml 0000664 0001750 0001750 00000000526 13577724336 017643 0 ustar jodal jodal 0000000 0000000 [build-system]
requires = ["setuptools >= 30.3.0", "wheel"]
[tool.black]
target-version = ["py37", "py38"]
line-length = 80
[tool.isort]
multi_line_output = 3
include_trailing_comma = true
force_grid_wrap = 0
use_parentheses = true
line_length = 88
known_tests = "tests"
sections = "FUTURE,STDLIB,THIRDPARTY,FIRSTPARTY,TESTS,LOCALFOLDER"
Mopidy-ALSAMixer-2.0.0/setup.cfg 0000664 0001750 0001750 00000002567 13577725111 016547 0 ustar jodal jodal 0000000 0000000 [metadata]
name = Mopidy-ALSAMixer
version = 2.0.0
url = https://github.com/mopidy/mopidy-alsamixer
author = Stein Magnus Jodal
author_email = stein.magnus@jodal.no
license = Apache License, Version 2.0
license_file = LICENSE
description = Mopidy extension for ALSA volume control
long_description = file: README.rst
classifiers =
Environment :: No Input/Output (Daemon)
Intended Audience :: End Users/Desktop
License :: OSI Approved :: Apache Software License
Operating System :: OS Independent
Programming Language :: Python :: 3
Programming Language :: Python :: 3.7
Programming Language :: Python :: 3.8
Topic :: Multimedia :: Sound/Audio :: Players
[options]
zip_safe = False
include_package_data = True
packages = find:
python_requires = >= 3.7
install_requires =
Mopidy >= 3.0.0
Pykka >= 2.0.1
setuptools
pyalsaaudio
[options.extras_require]
lint =
black
check-manifest
flake8
flake8-bugbear
flake8-import-order
isort[pyproject]
release =
twine
wheel
test =
pytest
pytest-cov
dev =
%(lint)s
%(release)s
%(test)s
[options.packages.find]
exclude =
tests
tests.*
[options.entry_points]
mopidy.ext =
alsamixer = mopidy_alsamixer:Extension
[flake8]
application-import-names = mopidy_alsamixer, tests
max-line-length = 80
exclude = .git, .tox, build
select =
C, E, F, W
B
B950
N
ignore =
E203
E501
W503
B305
[egg_info]
tag_build =
tag_date = 0
Mopidy-ALSAMixer-2.0.0/setup.py 0000664 0001750 0001750 00000000046 13577724336 016436 0 ustar jodal jodal 0000000 0000000 from setuptools import setup
setup()
Mopidy-ALSAMixer-2.0.0/tests/ 0000775 0001750 0001750 00000000000 13577725111 016056 5 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/tests/__init__.py 0000664 0001750 0001750 00000000000 13577724336 020165 0 ustar jodal jodal 0000000 0000000 Mopidy-ALSAMixer-2.0.0/tests/test_extension.py 0000664 0001750 0001750 00000001435 13577724336 021516 0 ustar jodal jodal 0000000 0000000 import unittest
from unittest import mock
from mopidy_alsamixer import Extension, mixer
class ExtensionTest(unittest.TestCase):
def test_get_default_config(self):
ext = Extension()
config = ext.get_default_config()
self.assertIn("[alsamixer]", config)
self.assertIn("enabled = true", config)
self.assertIn("card = 0", config)
self.assertIn("control = Master", config)
def test_get_config_schema(self):
ext = Extension()
schema = ext.get_config_schema()
self.assertIn("card", schema)
self.assertIn("control", schema)
def test_setup(self):
ext = Extension()
registry = mock.Mock()
ext.setup(registry)
registry.add.assert_called_once_with("mixer", mixer.AlsaMixer)
Mopidy-ALSAMixer-2.0.0/tests/test_mixer.py 0000664 0001750 0001750 00000023003 13577724336 020621 0 ustar jodal jodal 0000000 0000000 import unittest
from unittest import mock
import alsaaudio
from mopidy import exceptions
from mopidy_alsamixer.mixer import AlsaMixer
@mock.patch("mopidy_alsamixer.mixer.alsaaudio", spec=alsaaudio)
class MixerTest(unittest.TestCase):
default_config = {
"alsamixer": {
"card": 0,
"control": "Master",
"min_volume": 0,
"max_volume": 100,
"volume_scale": "cubic",
}
}
def get_mixer(self, alsa_mock=None, config=None, apply_default_config=True):
if config is None:
config = {"alsamixer": {"card": 0, "control": "Master"}}
if alsa_mock is not None:
alsa_mock.cards.return_value = ["PCH"]
alsa_mock.mixers.return_value = ["Master"]
if apply_default_config:
actual_config = MixerTest.default_config.copy()
actual_config["alsamixer"].update(config["alsamixer"])
else:
actual_config = config
return AlsaMixer(config=actual_config)
def test_has_config(self, alsa_mock):
config = {"alsamixer": {"card": 0, "control": "Master"}}
actual_config = MixerTest.default_config.copy()
actual_config["alsamixer"].update(config["alsamixer"])
mixer = self.get_mixer(
alsa_mock, config=actual_config, apply_default_config=False
)
self.assertIs(mixer.config, actual_config)
def test_use_card_from_config(self, alsa_mock):
alsa_mock.cards.return_value = ["PCH", "SB"]
alsa_mock.mixers.return_value = ["Master"]
config = {"alsamixer": {"card": 1, "control": "Master"}}
mixer = self.get_mixer(config=config)
mixer.get_volume()
alsa_mock.Mixer.assert_called_once_with(cardindex=1, control="Master")
def test_use_card_with_index_not_in_cards_list(self, alsa_mock):
alsa_mock.cards.return_value = ["PCH", "SB"]
alsa_mock.mixers.return_value = ["Master"]
config = {"alsamixer": {"card": 2, "control": "Master"}}
mixer = self.get_mixer(config=config)
mixer.get_volume()
alsa_mock.mixers.assert_called_once_with(2)
alsa_mock.Mixer.assert_called_once_with(cardindex=2, control="Master")
def test_fails_if_card_is_unknown(self, alsa_mock):
alsa_mock.cards.return_value = ["PCH", "SB"]
alsa_mock.mixers.side_effect = alsa_mock.ALSAAudioError(
"No such file or directory [hw:2]"
)
config = {"alsamixer": {"card": 2, "control": "Master"}}
with self.assertRaises(exceptions.MixerError):
self.get_mixer(config=config)
alsa_mock.mixers.assert_called_once_with(2)
def test_use_control_from_config(self, alsa_mock):
alsa_mock.cards.return_value = ["PCH", "SB"]
alsa_mock.mixers.return_value = ["Speaker"]
config = {"alsamixer": {"card": 0, "control": "Speaker"}}
mixer = self.get_mixer(config=config)
mixer.get_volume()
alsa_mock.Mixer.assert_called_once_with(cardindex=0, control="Speaker")
def test_fails_if_control_is_unknown(self, alsa_mock):
alsa_mock.cards.return_value = ["PCH", "SB"]
config = {"alsamixer": {"card": 0, "control": "Speaker"}}
with self.assertRaises(exceptions.MixerError):
self.get_mixer(config=config)
def test_get_volume(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "linear"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [86]
self.assertEqual(mixer.get_volume(), 86)
mixer_mock.getvolume.assert_called_once_with()
def test_get_volume_cubic(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "cubic"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [86]
self.assertEqual(mixer.get_volume(), 63)
mixer_mock.getvolume.assert_called_once_with()
def test_get_volume_log(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "log"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [86]
self.assertEqual(mixer.get_volume(), 52)
mixer_mock.getvolume.assert_called_once_with()
def test_get_volume_when_channels_are_different(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [86, 70]
self.assertIsNone(mixer.get_volume())
mixer_mock.getvolume.assert_called_once_with()
def test_get_volume_when_no_channels(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = []
self.assertIsNone(mixer.get_volume())
mixer_mock.getvolume.assert_called_once_with()
def test_set_volume(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "linear"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
self.assertTrue(mixer.set_volume(74))
mixer_mock.setvolume.assert_called_once_with(74)
def test_set_volume_cubic(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "cubic"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
self.assertTrue(mixer.set_volume(74))
mixer_mock.setvolume.assert_called_once_with(90)
def test_set_volume_log(self, alsa_mock):
config = {"alsamixer": {"volume_scale": "log"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer_mock = alsa_mock.Mixer.return_value
self.assertTrue(mixer.set_volume(74))
mixer_mock.setvolume.assert_called_once_with(93)
def test_get_mute_when_muted(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getmute.return_value = [1]
self.assertIs(mixer.get_mute(), True)
mixer_mock.getmute.assert_called_once_with()
def test_get_mute_when_unmuted(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getmute.return_value = [0]
self.assertIs(mixer.get_mute(), False)
mixer_mock.getmute.assert_called_once_with()
def test_get_mute_when_unsupported(self, alsa_mock):
alsa_mock.ALSAAudioError = alsaaudio.ALSAAudioError
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getmute.side_effect = alsa_mock.ALSAAudioError
self.assertIsNone(mixer.get_mute())
mixer_mock.getmute.assert_called_once_with()
def test_set_mute_to_muted(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
self.assertTrue(mixer.set_mute(True))
mixer_mock.setmute.assert_called_once_with(1)
def test_set_mute_when_unsupported(self, alsa_mock):
alsa_mock.ALSAAudioError = alsaaudio.ALSAAudioError
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.setmute.side_effect = alsa_mock.ALSAAudioError
self.assertFalse(mixer.set_mute(True))
mixer_mock.setmute.assert_called_once_with(1)
def test_get_mute_when_channels_are_different(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getmute.return_value = [0, 1]
self.assertIs(mixer.get_mute(), None)
mixer_mock.getmute.assert_called_once_with()
def test_set_mute_to_unmuted(self, alsa_mock):
mixer = self.get_mixer(alsa_mock)
mixer_mock = alsa_mock.Mixer.return_value
self.assertTrue(mixer.set_mute(False))
mixer_mock.setmute.assert_called_once_with(0)
def test_trigger_events_for_changed_values_when_no_change(self, alsa_mock):
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [70]
mixer_mock.getmute.return_value = [0]
mixer = self.get_mixer(alsa_mock)
mixer.trigger_volume_changed = mock.Mock()
mixer.trigger_mute_changed = mock.Mock()
mixer.trigger_events_for_changed_values()
alsa_mock.reset_mock()
mixer.trigger_volume_changed.reset_mock()
mixer.trigger_mute_changed.reset_mock()
mixer.trigger_events_for_changed_values()
mixer_mock.getvolume.assert_called_once_with()
mixer_mock.getmute.assert_called_once_with()
self.assertEqual(mixer.trigger_volume_changed.call_count, 0)
self.assertEqual(mixer.trigger_mute_changed.call_count, 0)
def test_trigger_events_for_changed_values_when_changes(self, alsa_mock):
mixer_mock = alsa_mock.Mixer.return_value
mixer_mock.getvolume.return_value = [75]
mixer_mock.getmute.return_value = [1]
config = {"alsamixer": {"volume_scale": "linear"}}
mixer = self.get_mixer(alsa_mock, config=config)
mixer.trigger_volume_changed = mock.Mock()
mixer.trigger_mute_changed = mock.Mock()
mixer.trigger_events_for_changed_values()
mixer_mock.getvolume.assert_called_once_with()
mixer_mock.getmute.assert_called_once_with()
mixer.trigger_volume_changed.assert_called_once_with(75)
mixer.trigger_mute_changed.assert_called_once_with(True)
Mopidy-ALSAMixer-2.0.0/tox.ini 0000664 0001750 0001750 00000000742 13577724336 016242 0 ustar jodal jodal 0000000 0000000 [tox]
envlist = py37, py38, black, check-manifest, flake8
[testenv]
sitepackages = true
deps = .[test]
commands =
python -m pytest \
--basetemp={envtmpdir} \
--cov=mopidy_alsamixer --cov-report=term-missing \
{posargs}
[testenv:black]
deps = .[lint]
commands = python -m black --check .
[testenv:check-manifest]
deps = .[lint]
commands = python -m check_manifest
[testenv:flake8]
deps = .[lint]
commands = python -m flake8 --show-source --statistics