https://github.com/andremiras/pycaw

Python Core Audio Windows Library
https://github.com/andremiras/pycaw

Last synced: 6 days ago
JSON representation

Python Core Audio Windows Library

• Host: GitHub
• URL: https://github.com/andremiras/pycaw
• Owner: AndreMiras
• License: mit
• Created: 2016-04-23T23:16:03.000Z (over 8 years ago)
• Default Branch: develop
• Last Pushed: 2024-09-26T10:26:59.000Z (3 months ago)
• Last Synced: 2024-12-12T16:09:06.540Z (13 days ago)
• Language: Python
• Size: 152 KB
• Stars: 386
• Watchers: 8
• Forks: 67
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Pycaw (Python Core Audio Windows)

[![Tests](https://github.com/AndreMiras/pycaw/actions/workflows/tests.yml/badge.svg)](https://github.com/AndreMiras/pycaw/actions/workflows/tests.yml)

[![Coverage Status](https://coveralls.io/repos/github/AndreMiras/pycaw/badge.svg?branch=develop)](https://coveralls.io/github/AndreMiras/pycaw?branch=develop)

[![PyPI release](https://github.com/AndreMiras/pycaw/workflows/PyPI%20release/badge.svg)](https://github.com/AndreMiras/pycaw/actions/workflows/pypi-release.yml)

[![PyPI version](https://badge.fury.io/py/pycaw.svg)](https://badge.fury.io/py/pycaw)

Pycaw is a Python library designed exclusively for controlling audio devices on **Windows** systems.

It allows programmatic access to audio sessions, volume control, and sound device management on the Windows platform.

> Note: Pycaw does not support macOS or Linux.

> It is built specifically for Windows using Core Audio APIs.

> If you're looking for similar functionality on other platforms, you'll need alternative libraries.

## Install

Latest stable release:

```bat

pip install pycaw

```

Development branch:

```bat

pip install https://github.com/AndreMiras/pycaw/archive/develop.zip

```

System requirements:

```bat

choco install visualcpp-build-tools

```

## Usage

```Python

from comtypes import CLSCTX_ALL

from pycaw.pycaw import AudioUtilities, IAudioEndpointVolume

devices = AudioUtilities.GetSpeakers()

interface = devices.Activate(

    IAudioEndpointVolume._iid_, CLSCTX_ALL, None)

volume = interface.QueryInterface(IAudioEndpointVolume)

volume.GetMute()

volume.GetMasterVolumeLevel()

volume.GetVolumeRange()

volume.SetMasterVolumeLevel(-20.0, None)

```

See more in the [examples](examples/) directory.

## Tests

See in the [tests](tests/) directory.