Quick Start

This guide walks you through playing your first audio and routing it to output zones.

1. Initialize Audio Devices

After launching MZAP, go to the Devices page and click Initialize Devices. MZAP will detect all available audio output devices and create zones for each channel.

Tip

MZAP supports DirectSound, WASAPI, and ASIO devices. The default output type is WASAPI, which provides the best balance of latency and compatibility.

2. Create a Player

Go to the Players page and click New Player. Give it a name (e.g., “Lobby Music”).

3. Load Audio

You can load audio from several sources:

• Local file: Browse for an MP3, FLAC, WAV, or other supported format
• Internet radio stream: Enter a stream URL (e.g., http://ice1.somafm.com/groovesalad-256-mp3)
• Media library: Search your indexed media library

4. Route to Zones

In the player card, check one or more zone checkboxes to route the player’s audio to those output zones. You can route a single player to multiple zones, or route multiple players to the same zone for mixing.

5. Play

Click the Play button. Audio will start flowing to all routed zones immediately.

What’s Next?

• Adjust zone volume and EQ: Click any zone to open its detail view with volume, mute, 10-band EQ, and compressor controls
• Set up playlists: Create playlists in the Media Library and assign them to players
• Schedule automation: Use the Scheduler to automate playback at specific times
• Save your workspace: Save the current state (players, routing, settings) as a workspace for instant recall

Quick API Test

MZAP exposes a REST API on port 5000. Try these commands to verify the API is working:

# List all zones
curl http://localhost:5000/api/zones

# List all players
curl http://localhost:5000/api/players

# Get routing matrix
curl http://localhost:5000/api/matrix

See the API Reference for the full endpoint documentation.