Welcome to musiccast2mqtt

MusicCast2MQTT is a gateway between your Yamaha MusicCast devices and your MQTT broker. It is based on the mqttgateway library. It translates incoming MQTT messages into MusicCast commands. The MQTT syntax required is flexible and configurable.

Installation

MusicCast2MQTT is available on pip. It is preferrable to use the --user option or use a virtual environment.

pip install --user musiccast2mqtt

Execution

pip installs an entry-point called musiccast2mqtt. Its location depends on your system but hopefully your PATH environment variable already points there, so you can type anywhere:

musiccast2mqtt

and you should see a bunch of logs on the console.

Next step is to configure the application. Check the documentation.

Any issues, let me know here.

Contents

• 1. Welcome
  • 1.1. Installation
  • 1.2. Execution
• 2. MusicCast gateway to MQTT
  • 2.1. Introduction
  • 2.2. Installation
  • 2.3. Configuration
  • 2.4. Launch
  • 2.5. Defining the audio-video System
  • 2.6. Naming Devices, Zones, Sources and Feeds
  • 2.7. Data Representation
  • 2.8. Interface Logic
  • 2.9. Audio-Video Concepts
• 3. Usage
  • 3.1. Addressing the MusicCast Gateway
  • 3.2. Sending commands
  • 3.3. Vocabulary
  • 3.4. Recognised actions
  • 3.5. Mapping
  • 3.6. Examples
• 4. Package Documentation
  • 4.1. Warning
  • 4.2. Modules