Skip to main content

Version 2025.1

Major Architecture Refactor​

This release features a significant refactor to a configuration-driven architecture, making it easier to maintain and extend CSV to QLab.

Build Changes

Starting with this release, builds are provided for:

  • macOS 11+ Intel - Supports all Intel Macs running macOS 11 or later
  • macOS 14 ARM - For Apple Silicon Macs
  • macOS 15 ARM - For Apple Silicon Macs

Older release versions remain available in release history.

New Features​

  • Command-Line Interface (CLI) - New cross-platform CLI for automation and scripting workflows
    • Install with pip install . for CLI-only or pip install .[gui] for full GUI support
    • Run with csv-to-qlab show.csv 127.0.0.1 5
    • Supports verbose, quiet, and JSON output modes
    • Perfect for batch processing, automation, and remote/SSH sessions
    • See CLI Advanced for automation and scripting
  • JSON-Based Configuration - All OSC properties now defined in qlab_osc_config.json
  • Enhanced Property Support - Added many new global and cue-specific properties
  • Auto-Properties - Automatic enabling of related settings (e.g., setting fade opacity auto-enables the checkbox)
  • Improved Validation - Better type checking and value validation for all properties

New Cue Properties​

  • Global Properties: Armed, Flagged, Auto Load, Duration, Pre/Post Wait
  • Audio/Video Cues: Level, Rate, Pitch, Loop controls, Start/End Time, Patch, Gang
  • Fade Cues: Fade And Stop Others, Fade And Stop Others Time, Do Volume, Do Fade
  • All existing MIDI and Network properties retained and improved

Developer Improvements​

  • No-Code Property Addition - Add new OSC properties by editing JSON config only
  • Comprehensive Documentation - New developer and reference documentation
  • Better Error Handling - Improved validation and error reporting with instance-based error handlers
  • Comprehensive Test Suite - 69 tests with 86% code coverage (added 19 CLI tests)
  • Duplicate Property Detection - Automated tests prevent configuration conflicts
  • Package Setup - New setup.py for pip installation with separate GUI and CLI dependencies
  • Proper Package Structure - Follows Python/PyInstaller best practices with app/ as a proper Python package

Documentation​

Download

Bug Fixes (v2025.1.1 - Hotfix)​

  • Fixed CLI Installation - Resolved ModuleNotFoundError when installing CLI via pip
    • Added app/__init__.py to properly mark app/ as a Python package
    • Converted all intra-package imports to relative imports (following PEP 8)
    • Created run_gui.py as external PyInstaller entry point (following PyInstaller best practices)
    • Updated all test imports to use proper package structure
    • All 69 tests now pass

For contributors: See the Architecture Overview and Adding Properties Guide for details on the new system.