Metadata-Version: 2.1
Name: np-audio-control
Version: 0.0.2.post2
Summary: Tools for remote control of Windows system audio on Mindscope Neuropixels and Behavior rigs.
Author-Email: Ben Hardcastle <ben.hardcastle@alleninstitute.org>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Project-URL: Repository, https://github.com/AllenInstitute/np_audio_control
Project-URL: Bug tracker, https://github.com/AllenInstitute/np_audio_control/issues
Requires-Python: <4,>=3.7
Requires-Dist: fabric>=3.0.0
Requires-Dist: np-config>=0.4.17
Requires-Dist: np-logging>=0.5.1
Requires-Dist: blue>=0.9.1; extra == "dev"
Requires-Dist: pytest>=7.2.2; extra == "dev"
Requires-Dist: mypy>=1.1.1; extra == "dev"
Requires-Dist: coverage[toml]>=7.2.2; extra == "dev"
Requires-Dist: pdm>=2.4.9; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: bump>=1.3.2; extra == "dev"
Requires-Dist: types-backports>=0.1.3; extra == "dev"
Requires-Dist: ruff>=0.0.260; extra == "dev"
Provides-Extra: dev
Description-Content-Type: text/markdown

# np_audio_control

[![Python
Versions](https://img.shields.io/pypi/pyversions/np_audio_control.svg)](https://pypi.python.org/pypi/np-audio-control/)

Tools for remote control of Windows system audio on Mindscope Neuropixels and Behavior rigs.

Uses SetVol v3.4 (https://www.rlatour.com/setvol/)


## Install
```shell
python -m pip install np_audio_control
```


## Basic usage
```python
>>> from np_audio_control import mute, unmute, set_volume, get_volume

>>> host = 'W10LTPC2BC51P'

# interact with default audio device 
>>> mute(host)
>>> unmute(host)
>>> set_volume(50, host)
>>> get_volume(host)
50

# interact with specific device (see SetVol `device name` argument)
>>> device = 'Speakers (Realtek USB2.0 Audio)'
>>> mute(host, device)
>>> set_volume(50, host, device)


# send any command to SetVol
>>> from np_audio_control import send_setvol_cmd
>>> send_setvol_cmd(host, 'beep')
```
