---
id: aiomusiccast
version: "0.15.0"
license: **The MIT License (MIT)** Copyright © 2021, Tom Schneider Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: unclear
maintenance: aging
---

# aiomusiccast — Companion library for musiccast devices intended for the Home Assistant integration.

License: unclear · Maintenance: aging · Downloads: 88.4K/mo

## What it is and what it does

aiomusiccast is an async Python client library for controlling MusicCast devices over a network connection. It wraps the MusicCast protocol in an async interface built on aiohttp, making it suitable for integration into Home Assistant or other async Python applications that need to discover, monitor, or control MusicCast speakers and receivers.

The library targets Python 3.10 through 3.14 and is maintained as a companion to Home Assistant's MusicCast integration. It handles the low-level protocol details of communicating with MusicCast devices, allowing developers to focus on higher-level control logic rather than raw network calls.

Use it for:

- Add MusicCast device discovery and control to Home Assistant automations or custom integrations
- Build async Python applications that monitor or adjust settings on MusicCast speakers
- Integrate MusicCast devices into multi-room audio orchestration or smart home workflows
- Query device status and capabilities from MusicCast receivers in real-time monitoring dashboards

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides async Python bindings to control MusicCast devices over the network, designed as a companion library for Home Assistant integration.

Yes, if you are building Home Assistant integrations or async Python applications that need to control MusicCast devices. The low install friction, permissive MIT license, and lack of known vulnerabilities make it a straightforward choice. The aging maintenance status (no release in 277 days) is a minor concern for new features but not a blocker for stable device control use cases.

## Install

pip install aiomusiccast
uv add aiomusiccast
poetry add aiomusiccast

## Installing aiomusiccast

Before you install: Low install friction with a single async dependency (aiohttp). Maintenance status is aging—last commit was 2025-11-09 and no release in 277 days—but the repository remains active and not archived.

License in practice: Licensed under MIT with full permissive terms; no restrictions on commercial or private use, modification, or redistribution.

Quickstart:

pip install aiomusiccast

import aiomusiccast
import aiohttp
import asyncio

async def main():
    async with aiohttp.ClientSession() as session:
        device = aiomusiccast.Device(session, "<device_ip>")
        await device.update()

Requires Python 3.10 or later; a MusicCast device accessible on the local network; aiohttp must be installed as a runtime dependency.

Verify before relying:

- Which MusicCast device models and API versions are supported by this library
- Scope and completeness of device control capabilities (commands, features implemented)
- Whether Home Assistant integration is actively maintained in parallel with this library
- Specific usage patterns and API surface beyond basic device communication

## Package facts

- License: **The MIT License (MIT)** Copyright &copy; 2021, Tom Schneider Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 88.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

musiccast device control, musiccast async python, home assistant musiccast, musiccast api client, async device control, home-assistant, async-io, device-control

[View on SkillFed](https://skillfed.io/packages/aiomusiccast) · [View on PyPI](https://pypi.org/project/aiomusiccast/)