companion-module-behringer-wing

See also HELP.md and LICENSE

Changelog

2.4.0

Breaking

• Requires Companion 5.0 or newer (module API v2.1, @companion-module/base ~2.1.3)
• The "Use Variables" checkboxes and their separate variable text fields were removed. Every option can now be switched to expression mode in Companion to use variables or expressions instead. Existing actions and feedbacks are converted by an upgrade script
• The percentage mode of "Adjust Fader Level" and "Adjust Direct Input Level" was removed. Existing percentage adjustments are converted to the equivalent dB value (percent / 100), which is how they were applied before
• Number options that used to be text fields are now number fields. Existing values and variables are converted automatically
• Removed the unused variables desk_ip and desk_name (they were never populated)
• Removed the "Debug Mode" configuration option. Use Companion's log level to see debug output instead

Added

• Status variables last_msg_received_timestamp, last_msg_path and last_msg_value for the last message received from the console
• Dropdowns list their valid values when switched to expression mode

Fixed

• Feedbacks and push/poll updates now update reliably
• Light presets ("Bright Lights" / "Dark Lights") work correctly and include the easing type
• Channel preset button text is shown correctly
• Talkback presets now toggle talkback instead of sending an invalid value
• Mute and Solo presets use valid option values
• The "Set SOF" action now respects its "Toggle" option. Existing "Set SOF" actions get "Toggle" enabled on upgrade to keep their previous behaviour
• The delay amount fields of "Set Delay Mode" are only shown for the selected delay mode again
• Text fields (Send Command, Set Name, Session Name) substitute variables again
• The main_alt_status variable is listed in Companion again
• Failing to auto-detect a console on the network (e.g. with multiple network interfaces) no longer marks the module as disconnected

Changed

• Switched to Companion's built-in module logger
• Presets were rewritten as template presets that can be used for any channel strip
• Feedbacks and presets are split into separate files per category

2.3.1

Changed

• An invalid OSC message results in the module entering an error state
• Bump from node18 to node22

2.3.0

Added

• Action to control monitor souce level (Set Monitor Source Level)
• Action to control monitor PFL dim (Set Monitor PFL Dim)
• Feedback for a channel strip's Sends-on-Fader status (SoF Active)
• Presets for Sends-on-Fader
• Added configuration options to select both the variable chunk size and variable chunk delay when prefetching variables

Fixed

• Fixed a performance issue with variables that would prevent variables from updating correctly under certain circumstances
• Fixed feedbacks not updating correctly due to inconsistency in internal and external state
• Changed name of variables/aux.ts to variables/auxiliary.ts to avoid build issues on Windows
• The module status badge now correctly reflects the connection status to the Behringer Wing device
• Detected consoles are listed correctly in the configuration IP dropdown
• Module now updates correctly when a detected console is selected in the configuration IP dropdown
• 'Mute' presets now correctly use the 'toggle' option from the Set Mute action
• 'Solo' presets now correctly use the 'toggle' option from the Set Solo action

Changed

• Variables are prefetched in configurable chunks with configurable delay between chunks
• The 'Set SOF' command now has a 'toggle' option
• Variables are now defined in separate files and aggregated in variables/index.ts for easier maintainability and expansion
• A variable definition now has the option to provide a command to specify the command to send during variable prefetching
• Reduced timeout until a console is no longer listed in the configuration IP dropdown from 60s to 20s
• Console messages are handled more efficiently using a debounce function
• Presets now use an expression for their name instead of a static string
• Increased logging details in connection-handler to show the type of all messaages in the log output

2.2.4

Added

• Added pre-push checks to ensure package version, README.md and git tag are in sync

Changed

• Refactored module for easier maintainability and expansion

2.2.3

Fixed

• Fixed mishandling of undefined variable in config file that would prevent a fresh instance of the module from starting

Added

• Added variables for channel, aux, bus, dca, matrix and main color names

2.2.0

Added

• Action to set the channel "Main Input Source" -> "Set Channel/Aux Main Connection"
• Action to set the channel "Alt Input Source" -> "Set Channel/Aux Alt Connection"
• Action to set the automatic switch between Main and Alt input source -> "Set Channel/Aux Auto Source Switch"
• Action to select whether a channel uses the Main or Alt input source -> "Set Channel/Aux Switch"
• Action to edit a channel strip's Icon -> "Set Channel Icon"
• Action to recall a schene by name -> "Recall Scene by Name"
• Action to recall a scene by number -> "Recall Scene by Number"
• Action to set light intensities of various console light sources -> "Set Light Intensities"
• New colors for Wing firmware 3.1
• Module option to prefetch all variables on startup
• Module option to enable forwarding of OSC messages from the Wing to another host with programmable IP and Port
• Presets for "Bright Lights" and "Dark Lights"
• All channel selection dropdowns now support selection using variables
• Issue Templates for bug reports and feature requests
• HELP.md file

Changed

• Version bumb of companion-module/base to 1.13
• Renamed color "Orange" to "Brown"
• Loads of under-the-hood refactoring and code cleanup for future release with better maintainability

2.1.0

Added

• Added unified send level, pan, and mute actions for all supported send combinations
• Added main/alt toggle action
• Added actions to enable/disable gate, dynamics, EQ, and inserts on supported channel strips
• Added save action
• Added more WLive actions, variables, and feedbacks
• Added SoF and Selected channel actions and variables

Changed

• Fixed issue where increment/decrement actions would not work correctly when current value is -inf

2.0.0

Added

• Support for Companion 3.0
• Device discovery listing Behringer Wing devices in configuration screen (inspired by Behringer X32)
• Fade-Curve Easings (copied from Behringer X32)
• Support for Wing Rack and Wing Comapct
• Added Commands:
  • Adjust Gain / Main to Matrix Level / Panorama / Send Panorama
  • Store Gain / Main to Matrix Level / Panorama / Send Panorama
  • Restore Gain / Main to Matrix Level / Panorama / Send Panorama
  • Undo Gain / Main to Matrix Level / Panorama / Send Panorama Adjust
  • Set Gain / Main to Matrix Level / Panorama / Send Panorama
  • Send Command
  • Send Command with Number
  • Set Channel EQ Model
  • Set Channel Filter Model
  • Set Channel Main Connection
  • Set Channel Process Order
  • Set Solo LR Swap
  • WLive: Set Link / Set Auto Input / Set Auto Stop / Set Auto Play / Set Auto Record / Card Action / Add Marker / Format Card
  • USB: Playback Action / Set Repeat / Record Action

Changed

• Re-structued repository to accomodate for large number of commands (inspired by ATEM)

  • chaned from action.ts to action/ as directory with one file per category
  • OSC commands are documented the commands/ directory, with one file per category. Each command category is its own namespace.

• Changed command names and unified commands:

  • Bus Send Level Adjust -> Adjust Send Level
  • Bus Send Level Recall -> Restore Send Level
  • Bus Send Level Set -> Set Send Level
  • Bus Send On -> Set Send Mute
  • Ch, Aux Send Level Adjust -> Adjust Send Level
  • Ch, Aux Send Level Recall -> Restore Send Level
  • Ch, Aux Send Level Set -> Set Send Level
  • Ch, Aux Send Level Store -> Store Send Level
  • Color -> Set Color
  • Fader Adjust -> Adjust Level
  • Fader Recall -> Restore Level
  • Fader Set -> Set Level
  • Fader Store -> Store Level
  • Icon -> Set Channel Icon
  • LED -> Set Scribble Light
  • Main Send Level Adjust -> Adjust Main Send Level
  • Main Send Level Recall -> Restore Main Send Level
  • Main Send Level Set -> Set Main Send Level
  • Main Send Level Store -> Set Main Send Mute
  • Mute -> Set Mute
  • Name -> Set Name
  • Solo -> Set Solo
  • Solo Clear -> Clear Solo
  • Solo Dim -> Set Solo Dim
  • Solo Mono -> Set Solo Mono
  • Solo Mute -> Set Solo Mute

1.0.4

Fixed

• Fix DCA Channel count (16 not 8)

1.0.3

Fixed

• Fix remaining switch/toggle actions

1.0.2

Fixed

• Fix Repo URL in HELP.md

1.0.1

Fixed

• Fix typos on certain mute actions

1.0.0

Added

• Implement a 'Clear All Solo' function

Changed

• Cleanup: remove excess debugging code

0.9.2

Added

• Talkback bus control

0.9.1

Added

• Feedback and Variables

0.9.0

Changed

• Protocol update

0.5.0

Added

• Initial release / testing
• Fader, Mute, LED, Colors, Solo, Sends
• With dynamic variables and Feedback