Livewire Command Line Interface

Audio Routing, GPIO, Console Control, & VMix

Livewire Command Line Interface (Livewire CLI) is a command-line tool to view and change Axia Livewire Audio Routes, Axia Livewire GPIO pin states, Axia Console Channel Settings, and VMix Settings. Simply run the EXEs, add the IP addresse of the LWRP or LWCP device you wish to control, and select from a wide range of parameters.

This tool allows you to automate many common Livewire tasks from the Windows Task Scheduler, Batch Files, or any Radio Automation System that allows you to trigger EXEs – using a very simple syntax to get and set many common properties in Axia devices. You could even call these EXEs from your own in-house software tools. When you purchase Livewire CLI, you receive two EXE:

  • Livewire-Routing-CLI.exe
    Control Axia Audio Routes, and GPIO.
  • Livewire-Control-CLI.exe
    Control Axia Consoles, and VMixes.

This app is focused on viewing and changing routes and GPIO changes from Livewire Routing Protocol Devices (Notes, QoRs, Processors, IP Drivers, etc.). It also now allows you to view or change V-Mixes and console settings on Axia Livewire consoles (Element, Fusion, Radius, iQ, and DESQ).

V-Mix settings on the Axia Radius, iQ and DESQ consoles is not supported.

This tool can be thought of as a command-line version of the Livewire Simple Delegation Switcher – with added support for Axia Console settings, perfect for automating regular tasks without other expensive software or hardware packages. This app is perfect for small Livewire networks.

Purchase Livewire CLI

Livewire Routing & Console Command Line Interface

Change Audio Routes, GPIO Pins, Console Faders, and Studio Engine VMixes on Livewire Routing Protocol devices, from the Windows command line.

USD $49 per-station

  • View and Change Livewire Audio Routes
  • View and Change GPIO Pin States
  • Control Livewire Devices from the Windows Task Scheduler
  • Unlimited LWRP &
  • LWCP Devices, Facility-wide
  • Control channel settings on Axia Element, Fusion, iQ, Radius, and DESQ consoles
  • Reload show profiles on Axia Element, Fusion, iQ, Radius, and DESQ consoles
  • Control VMix Channels on Element &
  • Fusion Studio Engines
  • Control VMix on iQ, Radius &
  • DESQ QORs

Each license you purchase is for one radio station (one unique audio output on FM, AM, DAB, Internet, HD Radio, or any other medium). We ask that you respect this licensing restrictions and purchase multiple copies based on the number of radio stations you’re running – but in reality we have no way of keeping tabs on your usage or enforcing this restriction. However, purchasing each license helps me develop this and other Livewire apps, such as my open source Livewire Simple Delegation Switcher and Livewire Routing Protocol Client for Python.

Livewire CLI was not created or endorsed by The Telos Alliance (the creators of Livewire). This is an independent software project that builds on top of other excellent Livewire products.

System Requirements

  • Windows 7 or later
  • Windows Server 2008 R2 or later
  • LAN access to Livewire Routing Protocol Devices (TCP Port 93), and/or Livewire Control Protocol Devices (TCP Port 4010)

Command Line Usage – Audio & GPIO

usage: Livewire-Routing-CLI.exe[-h] [-p PASSWORD] [--sourcenum SOURCENUM]
                       [--destinationnum DESTINATIONNUM]
                       [--gpio_port_num GPIO_PORT_NUM]
                       [--gpio_pin_num GPIO_PIN_NUM] [--get_name] [--get_ch]
                       [--get_chlw] [--get_chlwtype] [--get_gpiportstate]
                       [--get_gpipinstate] [--get_gpoportstate]
                       [--get_gpopinstate] [--set_ch XXX.XXX.XXX.XXX]
                       [--set_chlw 123]
                       [--set_chlwtype {standard,livestream,backfeed_standard,backfeed_livestream,surround}]
                       [--set_gpipinstate {HIGH,LOW}]
                       [--set_gpopinstate {HIGH,LOW}] [--debug]
                       [--disable_logging]
                       lwrp_ip

positional arguments:
  lwrp_ip               Enter the IP Address of your LWRP Device

optional arguments:
  -h, --help            show this help message and exit
  -p PASSWORD, --lwrp_password PASSWORD
                        The Password for your LWRP Device
  --sourcenum SOURCENUM
                        Enter the input channel number for your physical
                        device
  --destinationnum DESTINATIONNUM
                        Enter the output channel number for your physical
                        device
  --gpio_port_num GPIO_PORT_NUM
                        Enter the GPIO port number for your physical device
  --gpio_pin_num GPIO_PIN_NUM
                        Enter the GPIO pin number for your physical device
  --get_name            Get the current name of the specified channel
  --get_ch              Get the current channel number (raw) of the specified
                        channel
  --get_chlw            Get the current Livewire Stream Number of the
                        specified channel
  --get_chlwtype        Specify the Livewire Stream Type for the specified
                        channel
  --get_gpiportstate    Get the current state of all pins on the GPI port
  --get_gpipinstate     Get the current state of one specified pin on the GPI
                        port
  --get_gpoportstate    Get the current state of all pins on the GPO port
  --get_gpopinstate     Get the current state of one specified pin on the GPO
                        port
  --set_ch XXX.XXX.XXX.XXX
                        Change the current channel number (raw) of a specified
                        channel
  --set_chlw 123        Change the Livewire Stream Number of the specified
                        channel
  --set_chlwtype {standard,livestream,backfeed_standard,backfeed_livestream,surround}
                        Specify the Livewire Stream Type for the specified
                        channel
  --set_gpipinstate {HIGH,LOW}
                        Change the state of one specified pin on the GPO port
  --set_gpopinstate {HIGH,LOW}
                        Change the state of one specified pin on the GPO port
  --set_gpiomomentary   Specify this option to make this a momentary GPIO
                        trigger
  --debug               Specify this option to see debug/error output on the
                        console
  --disable_logging     Specify this option to disable logging to a file

If you are likely to run multiple instances of this app at the same time, we recommend you use the option ‘–disable_logging’ to disable logging to the hard-disk.

Command Line Usage – Console & VMix

usage: Livewire-Control-CLI.exe [-h] [--get_showprofile] [--get_showprofiles]
                                [--set_showprofile SET_SHOWPROFILE]
                                [--fadernum FADERNUM]
                                [--faderlivewire FADERLIVEWIRE]
                                [--get_sourceprofile] [--get_sourceprofiles]
                                [--set_sourceprofile SET_SOURCEPROFILE]
                                [--get_channelstate]
                                [--set_channelstate {ON,OFF}]
                                [--get_fadergain]
                                [--set_fadergain SET_FADERGAIN]
                                [--get_channelbus {ALL,PGM1,PGM2,PGM3,PGM4,PREV}
]
                                [--set_channelbus_pgm1 {ON,OFF}]
                                [--set_channelbus_pgm2 {ON,OFF}]
                                [--set_channelbus_pgm3 {ON,OFF}]
                                [--set_channelbus_pgm4 {ON,OFF}]
                                [--set_channelbus_prev {ON,OFF}]
                                [--vmix_num VMIX_NUM]
                                [--vmix_chnum VMIX_CHNUM] [--get_vmixstate]
                                [--set_vmixstate {ON,OFF}] [--get_vmixgain]
                                [--set_vmixgain SET_VMIXGAIN] [--debug]
                                [--disable_logging]
                                lwcp_ip

Livewire Control Command Line Interface (CLI). Copyright 2015-2018, Anthony
Eden / Media Realm. Version 1.1.0. This software is sold under a proprietary
license. Please purchase a license from https://mediarealm.com.au/.

positional arguments:
  lwcp_ip               Enter the IP Address of your LWCP Device

optional arguments:
  -h, --help            show this help message and exit
  --get_showprofile     Get the name and ID of the current show profile
  --get_showprofiles    Get the names and IDs of all configured show profiles
  --set_showprofile SET_SHOWPROFILE
                        Specify the ID of a Show Profile, to change the active
                        show profile on the desk
  --fadernum FADERNUM   Enter the fader number you wish to control
  --faderlivewire FADERLIVEWIRE
                        Enter the Livewire channel number you wish to control
                        on the console
  --get_sourceprofile   Get the name and ID of the current source profile
  --get_sourceprofiles  Get the names and IDs of all available source profiles
                        for the selected channel
  --set_sourceprofile SET_SOURCEPROFILE
                        Specify the ID of a Source Profile, to change the
                        active source profile for the selected channel
  --get_channelstate    Get the on/off button state of the currently selected
                        channel
  --set_channelstate {ON,OFF}
                        Change the on/off button state for the currently
                        selected channel
  --get_fadergain       Get the fader gain level of the currently selected
                        channel
  --set_fadergain SET_FADERGAIN
                        Set the fader gain level for the currently selected
                        channel
  --get_channelbus {ALL,PGM1,PGM2,PGM3,PGM4,PREV}
                        Get the bus assignment of the currently selected
                        channel
  --set_channelbus_pgm1 {ON,OFF}
                        Change the PGM1 Bus Assignment for the currently
                        selected channel
  --set_channelbus_pgm2 {ON,OFF}
                        Change the PGM1 Bus Assignment for the currently
                        selected channel
  --set_channelbus_pgm3 {ON,OFF}
                        Change the PGM1 Bus Assignment for the currently
                        selected channel
  --set_channelbus_pgm4 {ON,OFF}
                        Change the PGM1 Bus Assignment for the currently
                        selected channel
  --set_channelbus_prev {ON,OFF}
                        Change the PGM1 Bus Assignment for the currently
                        selected channel
  --vmix_num VMIX_NUM   Enter the VMix number you wish to control
  --vmix_chnum VMIX_CHNUM
                        Enter the VMix Channel number you wish to control
  --get_vmixstate       Get the on/off state of the currently selected VMix
                        channel
  --set_vmixstate {ON,OFF}
                        Change the on/off state for the currently selected
                        VMix channel
  --get_vmixgain        Get the on/off state of the currently selected VMix
                        channel
  --set_vmixgain SET_VMIXGAIN
                        Set the gain level for the currently selected VMix
                        channel
  --debug               Specify this option to see debug/error output on the
                        console
  --disable_logging     Specify this option to disable logging to a file

If you are likely to run multiple instances of this app at the same time, we recommend you use the option ‘–disable_logging’ to disable logging to the hard-disk.

Examples – Audio & Routing

These examples use the EXE ‘Livewire-Routing-CLI.exe’.

In all these examples, we’re connecting to the Livewire device on IP Address ‘127.0.0.1’.

  • Set Destination Channel #1 to Livewire Stream Number ‘123’:
    Livewire-Routing-CLI.exe 127.0.0.1 --destinationnum 1 --set_chlw 123
  • Set Destination Channel #1 to Livewire Stream Number ‘123’ (backstream):
    Livewire-Routing-CLI.exe 127.0.0.1 --destinationnum 1 --set_chlw 123 --set_chlwtype=backstream
  • Set Source Channel #1 to Livewire Stream Number ‘123′:
    Livewire-Routing-CLI.exe 127.0.0.1 --sourcenum 1 --set_chlw 123
  • Get Source Channel #1 Livewire Stream Number:
    Livewire-Routing-CLI.exe 127.0.0.1 --sourcenum 1 --get_chlw
  • Get GPO Port #1 Pin #2:
    Livewire-Routing-CLI.exe 127.0.0.1 --gpio_port_num 1 --gpio_pin_num 2 --get_gpopinstate
  • Get GPI Port #1 Pin #2:
    Livewire-Routing-CLI.exe 127.0.0.1 --gpio_port_num 1 --gpio_pin_num 2 --get_gpipinstate
  • Set GPO Port #1 Pin #2 to LOW:
    Livewire-Routing-CLI.exe 127.0.0.1 --gpio_port_num 1 --gpio_pin_num 2 —set_gpopinstate=LOW
  • Set GPO Port #1 Pin #2 to LOW (Momentary):
    Livewire-Routing-CLI.exe 127.0.0.1 --gpio_port_num 1 --gpio_pin_num 2 —set_gpopinstate=LOW --set_gpiomomentary

Examples – Console & VMix

These examples use the EXE ‘Livewire-Control-CLI.exe’.

In all these examples, we’re connecting to the Livewire Console device on IP Address ‘192.168.10.110’.

  • Get a list of show profiles
    Livewire-Control-CLI.exe 192.168.10.110 --get_showprofiles
  • Get the current show profile
    Livewire-Control-CLI.exe 192.168.10.110 --get_showprofile
  • Change the show profile to ID #2
    Livewire-Control-CLI.exe 192.168.10.110 --set_showprofiles=2
  • Get the list of source profiles available on console fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --get_sourceprofiles
  • Get the current source profile on console fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --get_sourceprofile
  • Change the source profile on console fader 1 to the Source Profile with ID #5
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --set_sourceprofile=5
  • Get the on/off button state for Fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --get_channelstate
  • Turn on Fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --set_channelstate=ON
  • Get the current fader gain level for Fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --get_fadergain
  • Change the fader gain for Fader 1 to -12dB
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --set_fadergain=-12
  • See all the bus assignments for Fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --get_channelbus=ALL
  • Enable PGM3 Bus for Fader 1
    Livewire-Control-CLI.exe 192.168.10.110 --fadernum=1 --set_channelbus_pgm3=ON
  • Get the current on/off state for VMix #1 Input #2
    Livewire-Control-CLI.exe 192.168.10.110 --vmix_num=1 --vmix_chnum=2 --get_vmixstate
  • Turn on VMix #1 Input #2
    Livewire-Control-CLI.exe 192.168.10.110 --vmix_num=1 --vmix_chnum=2 --set_vmixstate=ON
  • Get the current gain for VMix #1 Input #2
    Livewire-Control-CLI.exe 192.168.10.110 --vmix_num=1 --vmix_chnum=2 --get_vmixgain
  • Change the gain on VMix #1 Input #2 to -6dB
    Livewire-Control-CLI.exe 192.168.10.110 --vmix_num=1 --vmix_chnum=2 --set_vmixgain=-6

License

License Agreement for Livewire CLI
----------------------------------

Preamble: This Agreement, governs the relationship between You, a Business Entity, (hereinafter: Licensee) and Media Realm, whose principal place of business is PO Box 295, Winston Hills, NSW, 2153 (hereinafter: Licensor). This Agreement sets the terms, rights, restrictions and obligations on using Livewire CLI (hereinafter: The Software) created and owned by Licensor, as detailed herein

    License Grant: Licensor hereby grants Licensee a Personal, Non-assignable & non-transferable, Commercial with terms, Without the rights to create derivative works, Non-exclusive license, all with accordance with the terms set forth and other legal restrictions set forth in 3rd party software used while running Software.

        Limited: Licensee may use Software for the purpose of:
            Running Software on Licensee's Server[s], directly controlling the equipment of one radio station;

        Non Assignable & Non-Transferable: Licensee may not assign or transfer his rights and duties under this license.

        Commercial use allowed with restrictions: This software may only be used for the number of unique radio stations licensed from Media Realm. 

    Term & Termination: The Term of this license shall be until terminated. Licensor may terminate this Agreement, including Licensee's license in the case where Licensee :

        became insolvent or otherwise entered into any liquidation process; or

        exported The Software to any jurisdiction where licensor may not enforce his rights under this agreements in; or

        Licensee was in breach of any of this license's terms and conditions and such breach was not cured, immediately upon notification; or

        Licensee in breach of any of the terms of clause 2 to this license; or

        Licensee otherwise entered into any arrangement which caused Licensor to be unable to enforce his rights under this License.

    Payment: In consideration of the License granted under clause 2, Licensee shall pay Licensor a fee, via Credit-Card, or any other mean which Licensor may deem adequate. Failure to perform payment shall construe as material breach of this Agreement.

    Upgrades, Updates and Fixes: Licensor may provide Licensee, from time to time, with Upgrades, Updates or Fixes, as detailed herein and according to his sole discretion. Licensee hereby warrants to keep The Software up-to-date and install all relevant updates and fixes, and may, at his sole discretion, purchase upgrades, according to the rates set by Licensor. Licensor shall provide any update or Fix free of charge; however, nothing in this Agreement shall require Licensor to provide Updates or Fixes.

        Upgrades: for the purpose of this license, an Upgrade shall be a material amendment in The Software, which contains new features and or major performance improvements and shall be marked as a new version number. For example, should Licensee purchase The Software under version 1.X.X, an upgrade shall commence under number 2.0.0.

        Updates: for the purpose of this license, an update shall be a minor amendment in The Software, which may contain new features or minor improvements and shall be marked as a new sub-version number. For example, should Licensee purchase The Software under version 1.1.X, an upgrade shall commence under number 1.2.0.

        Fix: for the purpose of this license, a fix shall be a minor amendment in The Software, intended to remove bugs or alter minor features which impair the The Software's functionality. A fix shall be marked as a new sub-sub-version number. For example, should Licensee purchase Software under version 1.1.1, an upgrade shall commence under number 1.1.2.

    Support: Software is provided under an AS-IS basis and without any support, updates or maintenance. Nothing in this Agreement shall require Licensor to provide Licensee with support or fixes to any bug, failure, mis-performance or other defect in The Software.

        Bug Notification: Licensee may provide Licensor of details regarding any bug, defect or failure in The Software promptly and with no delay from such event; Licensee shall comply with Licensor's request for information regarding bugs, defects or failures and furnish him with information, screenshots and try to reproduce such bugs, defects or failures.

        Feature Request: Licensee may request additional features in Software, provided, however, that (i) Licensee shall waive any claim or right in such feature should feature be developed by Licensor; (ii) Licensee shall be prohibited from developing the feature, or disclose such feature request, or feature, to any 3rd party directly competing with Licensor or any 3rd party which may be, following the development of such feature, in direct competition with Licensor; (iii) Licensee warrants that feature does not infringe any 3rd party patent, trademark, trade-secret or any other intellectual property right; and (iv) Licensee developed, envisioned or created the feature solely by himself.

    Liability:  To the extent permitted under Law, The Software is provided under an AS-IS basis. Licensor shall never, and without any limit, be liable for any damage, cost, expense or any other payment incurred by Licensee as a result of Softwareís actions, failure, bugs and/or any other interaction between The Software  and Licenseeís end-equipment, computers, other software or any 3rd party, end-equipment, computer or services.  Moreover, Licensor shall never be liable for any defect in source code written by Licensee when relying on The Software or using The Softwareís source code.

    Warranty:  

        Intellectual Property: Licensor hereby warrants that The Software does not violate or infringe any 3rd party claims in regards to intellectual property, patents and/or trademarks and that to the best of its knowledge no legal action has been taken against it for any infringement or violation of any 3rd party intellectual property rights.

        No-Warranty: The Software is provided without any warranty; Licensor hereby disclaims any warranty that The Software shall be error free, without defects or code which may cause damage to Licenseeís computers or to Licensee, and that Software shall be functional. Licensee shall be solely liable to any damage, defect or loss incurred as a result of operating software and undertake the risks contained in running The Software on Licenseís Server[s] and Website[s].

        Prior Inspection: Licensee hereby states that he inspected The Software thoroughly and found it satisfactory and adequate to his needs, that it does not interfere with his regular operation and that it does meet the standards and scope of his computer systems and architecture. Licensee found that The Software interacts with his development, website and server environment and that it does not infringe any of End User License Agreement of any software Licensee may use in performing his services. Licensee hereby waives any claims regarding The Software's incompatibility, performance, results and features, and warrants that he inspected the The Software.

    No Refunds: Licensee warrants that he inspected The Software according to clause 7(c) and that it is adequate to his needs. Accordingly, as The Software is intangible goods, Licensee shall not be, ever, entitled to any refund, rebate, compensation or restitution for any reason whatsoever, even if The Software contains material flaws.

    Indemnification: Licensee hereby warrants to hold Licensor harmless and indemnify Licensor for any lawsuit brought against it in regards to Licenseeís use of The Software in means that violate, breach or otherwise circumvent this license, Licensor's intellectual property rights or Licensor's title in The Software. Licensor shall promptly notify Licensee in case of such legal action and request Licenseeís consent prior to any settlement in relation to such lawsuit or claim.

    Governing Law, Jurisdiction: Licensee hereby agrees not to initiate class-action lawsuits against Licensor in relation to this license and to compensate Licensor for any legal fees, cost or attorney fees should any claim brought by Licensee against Licensor be denied, in part or in full.