slaCmdr v2.5

Command-line automation for Phantom speakers

slaCmdr v2.5

slaCmdr - Command-line interface for Devialet Phantom speakers. Automate playback, volume control, and source management from scripts, shortcuts, or Stream Deck.

🆕 New in v2.5 (R25):

🗺️ Device name mapping via device_names.json
🎯 Play sources by index number for easier scripting
💻 Interactive CLI mode with command aliases
🔧 .NET 8 runtime for improved performance

Quick Start

Single executable - no installation required
Works with Windows 10/11 (.NET 8 runtime)
Compatible with Devialet firmware 2.14+
Create desktop shortcuts for one-click control

What is slaCmdr?

A powerful command-line tool that puts you in control of your Devialet Phantom speakers. Like a chameleon, it adapts to your automation needs - from simple desktop shortcuts to complex scripting scenarios.

🎯 Core Features

Full CLI Control: Play, pause, volume, source selection
Device Discovery: Automatic mDNS network scanning
Source Management: List and switch between all available sources
Interactive Shell: Real-time control with command aliases
Automation Ready: Perfect for scripts and scheduled tasks
Icon Library: Built-in icons for custom shortcuts

⚡ Perfect For

Desktop Shortcuts: One-click play/pause/volume controls
Stream Deck: Assign commands to physical buttons
Home Automation: Integrate with any system that can run commands
Touch Screens: Create simple control interfaces
Scheduled Tasks: Automate volume changes, source switching
Theater Software: Control audio from media applications

Download & Installation

Get slaCmdr

Latest Version: 2.5 (R25)

Download slaCmdr v2.5

Single executable • Requires .NET 8.0 Runtime • Updated: 7/27/2025

Installation

Download and extract the ZIP file
Rename the executable if desired (e.g., phantom.exe)
Run from command line or create shortcuts
.NET 8 will prompt to install if not present

Command Line Usage

Basic Syntax

slaCmdr.exe SystemIP Namespace -Operation

slaCmdr.exe -Connect SystemIP      (Interactive CLI)

slaCmdr.exe -Discover              (Find devices)

Quick Examples

# Discover all Phantom speakers on network
slaCmdr.exe -Discover

# Play current source
slaCmdr.exe 192.168.1.100 groups -Play

# Control volume
slaCmdr.exe 192.168.1.100 systems -VolUp
slaCmdr.exe 192.168.1.100 systems -VolDown

# Switch sources (by index or ID)
slaCmdr.exe 192.168.1.100 groups -PlaySource 3
slaCmdr.exe 192.168.1.100 groups -PlaySource spotify

# Interactive CLI mode
slaCmdr.exe -Connect 192.168.1.100
        

📝 Complete Command Reference

Discovery & Connection

-Discover - Find all Phantom devices on network
-Connect [IP] - Start interactive CLI session

Playback Control

-Play - Start playback of current source
-Pause - Pause current playback
-VolUp - Increase volume by 5%
-VolDown - Decrease volume by 5%

Source Management

-GetSourceList - List all available sources
-PlaySource [ID|Index|Name] - Switch to specific source
-GetNowPlaying - Get current playback information

Namespaces

devices - Control individual speakers
systems - Control stereo pairs
groups - Control multi-room groups

Desktop Shortcuts

Create one-click controls on your desktop:

🖱️ Creating Shortcuts

Right-click on desktop → New → Shortcut
Set target: C:\tools\slaCmdr.exe 192.168.1.100 groups -Play
Name it "Play Phantom"
Right-click → Properties → Change Icon
Browse to slaCmdr.exe and select from built-in icons
Optional: Assign a hotkey (e.g., Ctrl+Alt+P)

Interactive CLI Mode

Connect to a device for real-time control:

C:\> slaCmdr.exe -Connect 192.168.1.100

sla> help
[help]        - Show this help
[list]        - List available sources
[play]        - Start playback
[pause]       - Pause playback
[volup]       - Volume up (+5%)
[voldown]     - Volume down (-5%)
[playsource]  - Play specific source
[get]         - Get now playing info
[exit]        - Quit

sla> list
(0) optical      → [fb630679-d59c-4352-9739-d2f49645df96] ← on Phantom Left
(1) spotify      → [2b5b3f99-6937-4be6-a03e-1b95e150a927] ← on Phantom Right
(2) bluetooth    → [13026ed4-eb62-4dc7-9157-3d277bc49346] ← on Phantom Right
(3) airplay2     → [7efbb0ec-b7a4-433b-a362-e2c6c5c4ec97] ← on Phantom Right

sla> playsource 1
Playing source: spotify

sla> volup
Volume increased
        

CLI Aliases

Use shortened commands for faster control:

pl = play
pa = pause
v+ or + = volume up
v- or - = volume down
l or ls = list sources
g = get now playing
ps = play source

Device Name Mapping

Make your devices easier to identify with friendly names:

📁 Configuration File

slaCmdr creates device_names.json in its directory on first run. Edit this file to map device IDs to friendly names:

{
  "DeviceIds": {
    "e6e97c6f-0ac8-5a35-b68d-52f70cef57af": "Living Room Left",
    "a7e4a870-a141-529b-b564-13d71d18fc7c": "Living Room Right",
    "c8a05c46-3fc0-5111-aa47-56126ffd2d5a": "Bedroom",
    "9127538b-79cc-56db-84f1-09807255ec7f": "Office"
  }
}
            

Now your device lists will show friendly names instead of UUIDs!

Stream Deck Integration

🎮 Elgato Stream Deck Setup

Install "Advanced Launcher" plugin by BarRaider
Drag Advanced Launcher to a button
Set Application: C:\tools\slaCmdr.exe
Set Arguments: 192.168.1.100 groups -Play
Customize button icon and label

Recommended Button Layout:

Row 1: Play | Pause | Volume Up | Volume Down
Row 2: Spotify | Optical | Bluetooth | AirPlay

API Reference

Devialet API Endpoints Used

Now Playing: GET /current/sources/current
Source List: GET /current/sources
Play Source: POST /current/sources/{id}/playback/play
Playback: POST /current/sources/current/playback/{play|pause}
Volume: POST /current/sources/current/soundControl/{volumeUp|volumeDown}

Related Applications

Troubleshooting

🔧 Common Issues

Devices not found: Check firewall, ensure mDNS is enabled
.NET error: Install .NET 8 Runtime from Microsoft
Connection refused: Verify IP address and network connectivity
Commands not working: Check namespace (devices/systems/groups)

Contact

🌐 halrad.com/slaCmdr

📧 slcmdr@eltekco.com