Manuals
OSC Reference Documentation
KLANG:app and the KLANG Immersive In-Ear Mixing Processors communicate exclusively via Open Sound Control (OSC) UDP network messages on port 9110 and 9111.
KLANG osc command line tool
KLANG has developed a command line tool for Windows and Mac. This can be used to easily send OSC from the command line and try the commands described above.
Syntax: KLANGosc <IPaddress> <portNumber> <OSCaddressPattern> <argumentType1> <argument 1> <argumentType2> <argument2> …
This guide describes <OSCaddressPattern> <argumentType1> <argument 1> <argumentType2> <argument2> …
There are examples in the batch and shell scripts included in the download.
Downloads
GENERAL EULA
General EULA – FIRMWARE & UPDATES
Please read and make sure you understand this End User License Agreement before you use our products. Scroll to the bottom of this page to continue.
KLANG END USER LICENCE AGREEMENT
IMPORTANT- PLEASE READ CAREFULLY: THIS END-USER LICENCE AGREEMENT (“EULA”) IS A LEGAL AGREEMENT BETWEEN YOU (“YOU”) AND KLANG:technologies GmbH of Wespienstr. 8-10, 52062 Aachen, Germany (“KLANG”) FOR THE KLANG SOFTWARE THAT ACCOMPANIES THIS EULA, WHICH INCLUDES COMPUTER SOFTWARE/FIRMWARE WHICH MAY ALSO INCLUDE ASSOCIATED MEDIA, PRINTED MATERIALS “ONLINE” OR ELECTRONIC DOCUMENTATION, AND INTERNET-BASED SERVICES AND DOWNLOADED SOFTWARE AND ANY UPDATES (“SOFTWARE”).
YOU AGREE TO BE BOUND BY THE TERMS OF THIS EULA BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE.
If You do not agree to the following terms, or do not fulfil the requirements set out in this EULA, no licence is granted to You by this EULA and You may not use, install or download the Software (and any copies of the Software that You do hold must be deleted or destroyed).
- GRANT OF LICENCE.
1.1 In consideration of your paying any price charged for the Software or product sold by KLANG to You which contained the Software at point of sale (“Product”) and/or your compliance with these terms, KLANG grants to You the non-exclusive right to install and/or use the Software as specified in this EULA and in accordance with any documentation that accompanies the Product online or in paper format (and which includes, without limitation, the terms and conditions upon which KLANG sold the Product to You) (“ Documentation ”).
- THIRD PARTY SOFTWARE AND OPEN SOURCE SOFTWARE.
2.1 Some or all of the Software may consist of third party applications and packages which may be proprietary and / or open source software. You are obliged to comply with any additional licensing terms related to such third party applications. To the extent that this EULA contains any provision(s) which are contradictory to the terms of those third party applications and packages, the terms of those third party licenses shall apply to that Software as opposed to the terms of this EULA and the terms of this EULA shall not apply to them. Unless stated otherwise in the documentation that accompanies the Software or Product, KLANG does not provide any warranty, maintenance, technical or other support for third party applications and all warranties in the Software are disclaimed as set out in clause 9 below.
2.2 A list of the third party software, acknowledgement and licenses for each Product can be found at https://www.klang.com/license as may be updated from time to time.
2.3 Certain software libraries and other third party software included with the Software are free software and licensed under the terms of open source licenses. You may obtain a complete source code copy of such free software under the terms of the license if applicable, as provided at https://www.klang.com/license.
2.4 To the extent that the Software links to any open source software libraries (“OSS Libraries”) that are provided to You with the Software, nothing in this EULA shall affect Your rights under the licenses on which the owner of intellectual property rights in the relevant OSS Libraries (“Third Party Licensor”) has licensed the OSS Libraries, details of which can be found at https://www.klang.com/license. To the extent that Third Party Licensors have licensed OSS Libraries on the terms of v2.1 or v3 of the GNU Lesser General Public License issued by the Free Software Foundation (the “LGPL”), those OSS Libraries are licensed to You on the terms of the relevant LGPL and are referred to, in this clause 2.4 and in clause 6.1.4, as the LGPL Libraries. You may obtain a complete copy of the source code of the LPGL Libraries without charge at https://www.klang.com/license in order that You may modify the LGPL Libraries in accordance with the relevant LGPL, together with certain object code of the Software necessary to enable You to re-link any modified LGPL Library to the Software.
- EXPORT/IMPORT RESTRICTIONS.
The Software, including technical data, may be subject to U. S. export control laws, and may be subject to export or import regulations in your own and/or other countries. You agree to comply with all such regulations, and acknowledge that it is your responsibility to obtain all licenses to export, re-export, or import the Software. In particular, Software may not be downloaded, or otherwise exported or re-exported (i) into, or to a national or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria (as such listing may be revised from time to time) or any country to which the U.S. has embargoed goods; or (ii) to anyone on the U.S. Treasury Department’s list of Specially Designated Nations or the U.S. Commerce Department’s Table of Denial Orders.
- INTELLECTUAL PROPERTY RIGHTS.
KLANG reserves all rights not expressly granted to You in this EULA or third party licenses associated with it. The Software is protected by copyright and other intellectual property laws and treaties. KLANG or its suppliers own or have the right to license the title, copyright, and all other intellectual property rights in the Software. You shall have no rights in or to the Software other than the right to use it in accordance with the terms of this EULA.
- ADDITIONAL SOFTWARE/SERVICES.
This EULA applies to updates, supplements, or add-on components of the Software that KLANG may provide to You, including in accordance with clauses 2.2 and 2.3, or make available to You after the date You obtain your initial copy of the Software unless a further EULA is provided with these.
- LICENSEE’S UNDERTAKINGS
6.1 Except as expressly set out in this License or as permitted by any local law, you undertake:
6.1.1 not to copy the Software or Documentation except where such copying is incidental to normal (i.e. intended) use of the Software or where it is necessary for the purpose of back-up or operational security;
6.1.2 not to translate, merge, adapt, vary or modify the Software or Documentation, except to the extent that by virtue of § 69d of the German Urheberrechtsgesetz (Copyright Act) or other applicable copyright law, such actions cannot be prohibited;
6.1.3 not to permit the Software or any part of it to be combined with, or become incorporated in, any other programs, unless authorised by us in writing;
6.1.4 not to disassemble, decompile, reverse engineer or create derivative works based on the whole, or any part, of the Software nor attempt to do any such things except to the extent that (i) by virtue of § 69e of the German Urheberrechtsgesetz (Copyright Act) or other applicable copyright law, such actions cannot be prohibited, because they are essential for the purpose of achieving interoperability of the Software with another software program, and provided that the information obtained by you during such activities:
(a) is used only for the purpose of achieving interoperability of the Software with another software program; and
(b) is not unnecessarily disclosed or communicated to any third party without our prior written consent; and
(c) is not used to create any software which is substantially similar to the Software; and
(ii) the Software links to LGPL Libraries and reverse engineering of the Software is essential for debugging any modifications You have made to the LGPL Libraries.
6.1.5 where You are acting in the course of Your trade, business, craft or profession (“ Business Customer ”), not to permit the Software to be accessed through an electronic network beyond your normal place of business;
6.1.6 to keep all copies of the Software secure and to maintain accurate and up-to-date records of the number and locations of all copies of the Software;
6.1.7 to supervise and control use of the Software and (where you are a Business Customer) ensure that your employees, representatives and customers use the Software in accordance with the terms of this License.
6.2 Business Customers must permit us and our representatives, at all reasonable times and on reasonable advance notice, to inspect and have access to any premises at which the Software or the Documentation is being kept or used, to the Products and other relevant computer equipment located there, and to any records kept pursuant to this Licence, for the purpose of ensuring that you are complying with the terms of this License.
- TERMINATION.
Without prejudice to any other rights, KLANG may terminate this EULA if You fail to comply with any of the terms of this EULA. In such an event, all rights granted to You under this EULA shall cease, you must cease all activities authorised by this EULA and You must destroy all copies of the Software and all of its component parts within your control.
- LIMITED WARRANTY & YOUR EXCLUSIVE REMEDY.
8.1 Subject to clauses 9.3 and 9.4, KLANG warrants that the Software will perform substantially in accordance with the KLANG materials that accompany the Software for a period of ninety (90) days from the date of receipt. If an implied warranty or condition is created by the laws of your territory that cannot be excluded, You are entitled to rely upon it, but only as to defects discovered during the period of this limited warranty (ninety days).
8.2 KLANG’S ENTIRE LIABILITY, AND YOUR EXCLUSIVE REMEDY, UNDER THE LIMITED WARRANTY PROVIDED IN THIS CLAUSE, OR FOR ANY OTHER BREACH OF THIS EULA, OR FOR ANY OTHER LIABILITY RELATING TO THE SOFTWARE, SHALL BE (AT KLANG’S OPTION), (I) RETURN OF THE AMOUNT PAID (IF ANY) FOR THE SOFTWARE, OR (II) REPAIR OR REPLACEMENT OF THE SOFTWARE, TO THE EXTENT THAT IT DOES NOT MEET THE LIMITED WARRANTY.
8.3 You will receive the remedy elected by KLANG. You are responsible for any expenses You may incur. The Limited Warranty provided in this clause is void if failure of the Software has resulted from accident, abuse, misapplication, abnormal use, a virus, or combination of the Product or Software with any other product or software. Any replacement Software will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer, and KLANG will use reasonable efforts to provide your remedy within a reasonable time of your compliance with KLANG’s warranty remedy procedures.
- DISCLAIMERS.
9.1 The Limited Warranty that appears above is the only warranty made to You and is provided in lieu of any other express warranties or similar obligations (if any) created by any advertising, documentation, packaging, or other communications.
9.2 Except for the Limited Warranty and to the maximum extent permitted by applicable law, KLANG and its suppliers provide the Software and support services (if any) “AS IS” and “WITH ALL FAULTS”, and hereby disclaim all other warranties and conditions, whether express, implied or statutory, including, but not limited to, any (if any) implied warranties, duties or conditions of merchantability, of fitness for a particular purpose, of reliability or availability, of accuracy or completeness of responses, of results, of workmanlike effort, of lack of viruses, and of lack of negligence, all with regard to the Software, and the provision of or failure to provide support or other services, information, software, and related content through the Software or otherwise arising out of the use of the Software.
9.3 KLANG DOES NOT WARRANT THAT THE SOFTWARE IS FREE OF BUGS OR ERRORS, AND THE EXISTENCE OF SUCH WILL NOT RESULT IN KLANG (i) BEING IN BREACH OF THIS EULA OR (ii) INCURRING ANY LIABILITY.
Where you are a consumer and there is any conflict between the terms of this clause 9 and applicable consumer protection law, the consumer protection law shall apply.
- LIMITATION OF LIABILITY.
10.1 To the maximum extent permitted by applicable law, and except as provided in any KLANG guarantee provided with the Software or Product and the Limited Warranty (above), KLANG and its suppliers shall not be liable for any damages whatsoever (including without limitation, damages for loss of data, loss of business profits or business opportunity, business interruption, loss of business information or other direct, indirect, consequential or pecuniary loss) arising out of the use or inability to use the Software, even if KLANG has been advised of the possibility of such damages.
10.2 (WITHOUT PREJUDICE TO CLAUSE 8.2) IN ANY CASE KLANG’S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS EULA SHALL BE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU FOR THE SOFTWARE. THESE LIMITATIONS DO NOT APPLY TO ANY LIABILITIES THAT CANNOT BE EXCLUDED OR LIMITED BY APPLICABLE LAWS. SUBJECT TO THE FOREGOING, KLANG’S LIABILITY FOR INFRINGEMENT OF THIRD PARTY INTELLECTUAL PROPERTY RIGHTS SHALL BE LIMITED TO BREACHES OF RIGHTS SUBSISTING IN GERMANY.
10.3 Where you are a consumer and there is any conflict between the terms of this clause 10 and applicable consumer protection law the consumer protection law shall apply.
- GENERAL.
11.1 Save where the Software forms part of a Product, this EULA constitutes the entire agreement between You and KLANG relating to the Software and they supersede all prior or contemporaneous oral or written communications, proposals and representations with respect to the Software or any other subject matter covered by this EULA.
11.2 This EULA is binding on You and KLANG and on any respective successors and assigns.
11.3 If any provision of this EULA is held by a competent authority to be illegal, invalid, void or unenforceable under the laws of any jurisdiction, such term, condition or provision will to that extent be severed from the remaining terms, conditions and provisions which will continue to be valid to the fullest extent permitted by law.
11.4 If KLANG fails, at any time during the term of this EULA to insist upon strict performance of any of your obligations under this EULA, or if it fails to exercise any of the rights or remedies to which it is entitled under this EULA, this shall not constitute a waiver of such rights or remedies and shall not relieve You from compliance with such obligations. A waiver by KLANG of any default shall not constitute a waiver of any subsequent default. No waiver by KLANG of any of these terms and conditions shall be effective unless it is expressly stated to be a waiver and is communicated to you in writing.
11.5 KLANG will not be liable or responsible for any failure to perform, or delay in performance of, any of its obligations under this License that are caused by an event outside of its reasonable control.
11.6 All notices given by You to KLANG must be given to KLANG:technologies GmbH, Wespienstr. 8-10, 52062 Aachen, Germany. KLANG may give notice to You at your most recent address (be it physical or e-mail) known to KLANG, and/or through a notice posted on KLANG’s then website.
11.7 This license shall be governed and construed in accordance with the laws of Germany excluding its conflict of law provisions and the United Nations Convention on Contracts for the International Sale of Goods (CISG). Any dispute arising from or related to this EULA shall be subject to the jurisdiction of the courts of Düsseldorf, Germany. Where You use the Software outside of Germany, the local law may impose greater restrictions on You that You must comply with.
- YOUR ACKNOWLEDGMENT:
YOU ACKNOWLEDGE THAT YOU HAVE READ THIS EULA, UNDERSTAND IT, AND AGREE BY USING THE SOFTWARE TO BE BOUND BY ITS TERMS.
Should you have any questions concerning this EULA, please contact:
info@klang.com
or
KLANG:technologies GmbH
Wespienstr. 8-10
52062 Aachen
Germany
Phone: +49 241 89030120
General EULA – free KLANG software
Please read and make sure you understand this End User License Agreement before you download and/or install any software from this website or app store which contain software. Scroll to the bottom of this page to continue.
KLANG END USER LICENCE AGREEMENT
IMPORTANT- PLEASE READ CAREFULLY: THIS END-USER LICENCE AGREEMENT (“EULA”) IS A LEGAL AGREEMENT BETWEEN YOU (“YOU”) AND KLANG:technologies GmbH of Wespienstr. 8-10, 52062 Aachen, Germany (“KLANG”) FOR THE KLANG SOFTWARE THAT ACCOMPANIES THIS EULA, WHICH INCLUDES COMPUTER SOFTWARE WHICH MAY ALSO INCLUDE ASSOCIATED MEDIA, “ONLINE” OR ELECTRONIC DOCUMENTATION, AND INTERNET-BASED SERVICES AND DOWNLOADED SOFTWARE AND ANY UPDATES (“SOFTWARE”).
YOU AGREE TO BE BOUND BY THE TERMS OF THIS EULA BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE.
If You do not agree to the following terms, or do not fulfil the requirements set out in this EULA, no licence is granted to You by this EULA and You may not use, install or download the Software (and any copies of the Software that You do hold must be deleted or destroyed).
- GRANT OF LICENCE.
1.1 In consideration of your compliance with these terms, KLANG grants to You the non-exclusive right to install and/or use the Software as specified in this EULA and in accordance with any documentation that accompanies the Software online (“ Documentation ”).
- THIRD PARTY SOFTWARE AND OPEN SOURCE SOFTWARE.
2.1 Some or all of the Software may consist of third party applications and packages which may be proprietary and / or open source software. You are obliged to comply with any additional licensing terms related to such third party applications. To the extent that this EULA contains any provision(s) which are contradictory to the terms of those third party applications and packages, the terms of those third party licenses shall apply to that Software as opposed to the terms of this EULA and the terms of this EULA shall not apply to them. Unless stated otherwise in the documentation that accompanies the Software or Product, KLANG does not provide any warranty, maintenance, technical or other support for third party applications and all warranties in the Software are disclaimed as set out in clause 9 below.
2.2 A list of the third party software, acknowledgement and licenses for each Software product can be found at https://www.klang.com/license as may be updated from time to time.
2.3 Certain software libraries and other third party software included with the Software are free software and licensed under the terms of open source licenses. You may obtain a complete source code copy of such free software under the terms of the license if applicable, as provided at https://www.klang.com/license.
2.4 To the extent that the Software links to any open source software libraries (“OSS Libraries”) that are provided to You with the Software, nothing in this EULA shall affect Your rights under the licenses on which the owner of intellectual property rights in the relevant OSS Libraries (“Third Party Licensor”) has licensed the OSS Libraries, details of which can be found at https://www.klang.com/license. To the extent that Third Party Licensors have licensed OSS Libraries on the terms of v2.1 or v3 of the GNU Lesser General Public License issued by the Free Software Foundation (the “LGPL”), those OSS Libraries are licensed to You on the terms of the relevant LGPL and are referred to, in this clause 2.4 and in clause 6.1.4, as the LGPL Libraries. You may obtain a complete copy of the source code of the LPGL Libraries without charge at https://www.klang.com/license in order that You may modify the LGPL Libraries in accordance with the relevant LGPL, together with certain object code of the Software necessary to enable You to re-link any modified LGPL Library to the Software.
- EXPORT/IMPORT RESTRICTIONS.
The Software, including technical data, may be subject to U. S. export control laws, and may be subject to export or import regulations in your own and/or other countries. You agree to comply with all such regulations, and acknowledge that it is your responsibility to obtain all licenses to export, re-export, or import the Software. In particular, Software may not be downloaded, or otherwise exported or re-exported (i) into, or to a national or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria (as such listing may be revised from time to time) or any country to which the U.S. has embargoed goods; or (ii) to anyone on the U.S. Treasury Department’s list of Specially Designated Nations or the U.S. Commerce Department’s Table of Denial Orders.
- INTELLECTUAL PROPERTY RIGHTS.
KLANG reserves all rights not expressly granted to You in this EULA or third party licenses associated with it. The Software is protected by copyright and other intellectual property laws and treaties. KLANG or its suppliers own or have the right to license the title, copyright, and all other intellectual property rights in the Software. You shall have no rights in or to the Software other than the right to use it in accordance with the terms of this EULA.
- ADDITIONAL SOFTWARE/SERVICES.
This EULA applies to updates, supplements, or add-on components of the Software that KLANG may provide to You, including in accordance with clauses 2.2 and 2.3, or make available to You after the date You obtain your initial copy of the Software unless a further EULA is provided with these.
- LICENSEE’S UNDERTAKINGS
6.1 Except as expressly set out in this License or as permitted by any local law, you undertake:
6.1.1 not to copy the Software or Documentation except where such copying is incidental to normal (i.e. intended) use of the Software or where it is necessary for the purpose of back-up or operational security;
6.1.2 not to translate, merge, adapt, vary or modify the Software or Documentation, except to the extent that by virtue of § 69d of the German Urheberrechtsgesetz (Copyright Act) or other applicable copyright law, such actions cannot be prohibited;
6.1.3 not to permit the Software or any part of it to be combined with, or become incorporated in, any other programs, unless authorised by us in writing;
6.1.4 not to disassemble, decompile, reverse engineer or create derivative works based on the whole, or any part, of the Software nor attempt to do any such things except to the extent that (i) by virtue of § 69e of the German Urheberrechtsgesetz (Copyright Act) or other applicable copyright law, such actions cannot be prohibited, because they are essential for the purpose of achieving interoperability of the Software with another software program, and provided that the information obtained by you during such activities:
(a) is used only for the purpose of achieving interoperability of the Software with another software program; and
(b) is not unnecessarily disclosed or communicated to any third party without our prior written consent; and
(c) is not used to create any software which is substantially similar to the Software; and
(ii) the Software links to LGPL Libraries and reverse engineering of the Software is essential for debugging any modifications You have made to the LGPL Libraries.
6.1.5 where You are acting in the course of Your trade, business, craft or profession (“ Business Customer ”), not to permit the Software to be accessed through an electronic network beyond your normal place of business;
6.1.6 to keep all copies of the Software secure and to maintain accurate and up-to-date records of the number and locations of all copies of the Software;
6.1.7 to supervise and control use of the Software and (where you are a Business Customer) ensure that your employees, representatives and customers use the Software in accordance with the terms of this License.
6.2 Business Customers must permit us and our representatives, at all reasonable times and on reasonable advance notice, to inspect and have access to any premises at which the Software or the Documentation is being kept or used, to the Products and other relevant computer equipment located there, and to any records kept pursuant to this Licence, for the purpose of ensuring that you are complying with the terms of this License.
- TERMINATION.
Without prejudice to any other rights, KLANG may terminate this EULA if You fail to comply with any of the terms of this EULA. In such an event, all rights granted to You under this EULA shall cease, you must cease all activities authorised by this EULA and You must destroy all copies of the Software and all of its component parts within your control.
- LIMITED WARRANTY & YOUR EXCLUSIVE REMEDY.
8.1 Subject to clauses 9.3 and 9.4, KLANG warrants that the Software will perform substantially in accordance with the KLANG materials that accompany the Software for a period of ninety (90) days from the date of receipt. If an implied warranty or condition is created by the laws of your territory that cannot be excluded, You are entitled to rely upon it, but only as to defects discovered during the period of this limited warranty (ninety days).
8.2 KLANG’S ENTIRE LIABILITY, AND YOUR EXCLUSIVE REMEDY, UNDER THE LIMITED WARRANTY PROVIDED IN THIS CLAUSE, OR FOR ANY OTHER BREACH OF THIS EULA, OR FOR ANY OTHER LIABILITY RELATING TO THE SOFTWARE, SHALL BE (AT KLANG’S OPTION), (I) RETURN OF THE AMOUNT PAID (IF ANY) FOR THE SOFTWARE, OR (II) REPAIR OR REPLACEMENT OF THE SOFTWARE, TO THE EXTENT THAT IT DOES NOT MEET THE LIMITED WARRANTY.
8.3 You will receive the remedy elected by KLANG. You are responsible for any expenses You may incur. The Limited Warranty provided in this clause is void if failure of the Software has resulted from accident, abuse, misapplication, abnormal use, a virus, or combination of the Product or Software with any other product or software. Any replacement Software will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer, and KLANG will use reasonable efforts to provide your remedy within a reasonable time of your compliance with KLANG’s warranty remedy procedures.
- DISCLAIMERS.
9.1 The Limited Warranty that appears above is the only warranty made to You and is provided in lieu of any other express warranties or similar obligations (if any) created by any advertising, documentation, packaging, or other communications.
9.2 Except for the Limited Warranty and to the maximum extent permitted by applicable law, KLANG and its suppliers provide the Software and support services (if any) “AS IS” and “WITH ALL FAULTS”, and hereby disclaim all other warranties and conditions, whether express, implied or statutory, including, but not limited to, any (if any) implied warranties, duties or conditions of merchantability, of fitness for a particular purpose, of reliability or availability, of accuracy or completeness of responses, of results, of workmanlike effort, of lack of viruses, and of lack of negligence, all with regard to the Software, and the provision of or failure to provide support or other services, information, software, and related content through the Software or otherwise arising out of the use of the Software.
9.3 KLANG DOES NOT WARRANT THAT THE SOFTWARE IS FREE OF BUGS OR ERRORS, AND THE EXISTENCE OF SUCH WILL NOT RESULT IN KLANG (i) BEING IN BREACH OF THIS EULA OR (ii) INCURRING ANY LIABILITY.
Where you are a consumer and there is any conflict between the terms of this clause 9 and applicable consumer protection law, the consumer protection law shall apply.
- LIMITATION OF LIABILITY.
10.1 To the maximum extent permitted by applicable law, and except as provided in any KLANG guarantee provided with the Software or Product and the Limited Warranty (above), KLANG and its suppliers shall not be liable for any damages whatsoever (including without limitation, damages for loss of data, loss of business profits or business opportunity, business interruption, loss of business information or other direct, indirect, consequential or pecuniary loss) arising out of the use or inability to use the Software, even if KLANG has been advised of the possibility of such damages.
10.2 (WITHOUT PREJUDICE TO CLAUSE 8.2) IN ANY CASE KLANG’S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS EULA SHALL BE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU FOR THE SOFTWARE. THESE LIMITATIONS DO NOT APPLY TO ANY LIABILITIES THAT CANNOT BE EXCLUDED OR LIMITED BY APPLICABLE LAWS. SUBJECT TO THE FOREGOING, KLANG’S LIABILITY FOR INFRINGEMENT OF THIRD PARTY INTELLECTUAL PROPERTY RIGHTS SHALL BE LIMITED TO BREACHES OF RIGHTS SUBSISTING IN GERMANY.
10.3 Where you are a consumer and there is any conflict between the terms of this clause 10 and applicable consumer protection law the consumer protection law shall apply.
- GENERAL.
11.1 This EULA constitutes the entire agreement between You and KLANG relating to the Software and they supersede all prior or contemporaneous oral or written communications, proposals and representations with respect to the Software or any other subject matter covered by this EULA.
11.2 This EULA is binding on You and KLANG and on any respective successors and assigns.
11.3 If any provision of this EULA is held by a competent authority to be illegal, invalid, void or unenforceable under the laws of any jurisdiction, such term, condition or provision will to that extent be severed from the remaining terms, conditions and provisions which will continue to be valid to the fullest extent permitted by law.
11.4 If KLANG fails, at any time during the term of this EULA to insist upon strict performance of any of your obligations under this EULA, or if it fails to exercise any of the rights or remedies to which it is entitled under this EULA, this shall not constitute a waiver of such rights or remedies and shall not relieve You from compliance with such obligations. A waiver by KLANG of any default shall not constitute a waiver of any subsequent default. No waiver by KLANG of any of these terms and conditions shall be effective unless it is expressly stated to be a waiver and is communicated to you in writing.
11.5 KLANG will not be liable or responsible for any failure to perform, or delay in performance of, any of its obligations under this License that are caused by an event outside of its reasonable control.
11.6 All notices given by You to KLANG must be given to KLANG:technologies GmbH, Wespienstr. 8-10, 52062 Aachen, Germany. KLANG may give notice to You at your most recent address (be it physical or e-mail) known to KLANG, and/or through a notice posted on KLANG’s then website.
11.7 This license shall be governed and construed in accordance with the laws of Germany excluding its conflict of law provisions and the United Nations Convention on Contracts for the International Sale of Goods (CISG). Any dispute arising from or related to this EULA shall be subject to the jurisdiction of the courts of Düsseldorf, Germany. Where You use the Software outside of Germany, the local law may impose greater restrictions on You that You must comply with.
- YOUR ACKNOWLEDGMENT:
YOU ACKNOWLEDGE THAT YOU HAVE READ THIS EULA, UNDERSTAND IT, AND AGREE BY USING THE SOFTWARE TO BE BOUND BY ITS TERMS.
Should you have any questions concerning this EULA, please contact:
info@klang.com
or
KLANG:technologies GmbH
Wespienstr. 8-10
52062 Aachen
Germany
Phone: +49 241 89030120
Definitions
Naming and Typing Convention
The receiving device’s type is encoded in the address pattern:
- For KLANG hardware, it is always called fabrik – /KLANGfabrik (long pattern) or /Kf (short pattern)
- For KLANG:app – /KLANGapp (long pattern) or /Ka (short pattern)
In the following the OSC syntax is shown for the long pattern:
- String – s (we use hyph)
- Integer – i
- Float – f
- Bool – b/B – possible argument is <ONorOFF> which is either 1 | TRUE or 0 | FALSE.
A unique identifier <UID> is required to be attached as a string in the end of each long pattern OSC message with exactly 32 or 4 characters identifying the remote device uniquely, e.g. use a string like: “ABCD”
Example:
- /KLANGfabrik/user/MasterSlider f 1 s “ABCD”
- Send to address /KLANGfabrik/user/MasterSlider one float (f) which is ‘1’ and one string (s) which is ABCD.
UDP Ports and Answer Messages
OSC is send via UDP packets strictly on port 9110 to KLANG hardware
The KLANG processor sends back answers on the specified <ReceivePort> – default value is 9111.
Controlling the mix/user settings is implemented in two ways. The first approach uses a handshake prior to sending controls of e.g. level or position for this particular mix.
The second approach encodes the mix number in the address pattern and as referred to as SHORT in the following.
Handshake (required for LONG syntax)
A handshake and a switch user command must be sent before using any long format OSC messages. in the normal format syntax, since the user number is not encoded in the message. This handshake ist not required for the short synthax messages.
- /KLANGfabrik/control/ConnectRequest i <ReceivePort> s <UID>
Answers or responses to this handshake are included in:
- /KLANGapp/control/UserInfo
The latter one is followed by these arguments ‘Name’,’ Icon’, ‘outputUser’, ‘password’, ‘SN’, ‘localIP’, ‘localPort’, ‘typeOfProduct’, ‘Firmware’, ‘LinkedOutput’, ‘UID’. Furthermore, relayed messages may be sent.
Switch mix/user
Switch to another mix to accept the subsequent control messages of e.g. level and position.
-
- /KLANGfabrik/control/SwitchUser i <MIXnumber> s <password> s <UID>
-
- <MIXnumber> corresponds to the labeling of the analog outputs in normal configuration USER1 to USER8. If not routed to the DAC or something else is changed in routing it corresponds to the output channels of the DSP in the following way: USER1 – channel 1–2, USER2 – channel 3–4 etc. This option should be preferred.
-
- <password> is an empty string “” if not changed.
Level meters
Meters are continuously sent (every 50–200ms) to remote control devices with the following syntax:
- /KLANGfabrik/user/OutputLevelMeterUpdate, ‘iffiff…’
- /KLANGfabrik/user/InputLevelMeterUpdate, ‘iffiff…’
- Devices that did not send any message for more than 60 seconds will not receive any further messages.
These messages can be disabled by:
- /KLANGfabrik/user/wantsMeterUpdates b <ONorOFF > s <UID>
Relayed messages
Deactivate the relay of incoming messages to KLANG hardware from another remote control to your remote control device.
- /KLANGfabrik/user/DeviceWantsRelayedMessages b <ONorOFF> s <UID>
Controlling KLANG Hardware
Mix Master Volume
Controls the overall level of the entire mix of a user. <linearGAIN> floating point number between 0 (-infinity dBFS) and 1 (0 dBFS) in linear scale.
- /Kf/ui/<MIXnumber>/gain f <linearGAIN>
- /Kf/ui/<MIXnumber>/gaindB ‘f’ <GAIN in dB>
Mix Name
- /Kf/ui/ <MIXnumber> /name s <mixName>
Channel GAIN
Set the volume for a input channel <ChannelNumber> for a particular mix <MIXnumber>. The <ChannelNumber> is the number of the input channel to the 3D in-ear mixing engine as shown unter CONFIG > CHANNELS > INPUT.
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/gain f <linearGAIN>
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/gaindB f <GAIN in dB>
Channel ACTIVITY
Setting the visibility of an input channel (invisible channels are inherently muted):
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/visible b <ONorOFF>
Channel MUTE
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/mute b <ONorOFF>
Channel SOLO
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/solo b <ONorOFF>
Channel NAME
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/name s <channelName>
Channel COLOR
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/color s <channelColorAs8DigitHexValue>
- channelColorAs8DigitHexValue contains alpha, red, green, blue, e.g. FFFF0000 is red
Channel ICON
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/name s <iconName>
Channel STEREO LINK
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/stereo i <otherChannelNumberToBeLinked>
- -1 to unlink
Channel GROUP ASSIGN
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/grp i <groupIndexStartWithZero>
Placement, Panning
The general placement mode for a mix can be set by
- /Kf/ui/<mixNumber>/mode i <PlacementMode>
PlacementMode: 1=mono, 2=stereo, 3=3D, 4=i3D
Channel ELEVATION
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/ele f <ElevationAngleInDegrees>
<ElevationAngleInDegrees> is the angle in degrees between –90° (below), 0° (on the horizon) and 90° (above).
Channel AZIMUTH
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber> /azi f <AzimuthInDegrees>
<AzimuthInDegrees> is the angle in degrees between 0° (in front), 90° (right) 180° (behind), -90 or 270 (left) and 360° (in front again).
Channel WIDTH (for stereo linked channels)
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber> /width f <WidthInDegrees>
Channel MODE
The source is transfered from mono to stereo, to the 3D and i3D orbit by the following message with <Mode> being 1, 2, 3, and 4 respectively:
- /Kf/ui/<MIXnumber>/ch/<ChannelNumber>/mode i <Mode>
Cue mode
The CUE mode mirrors the output of one user to another user. A handshake has to be passed at least once in the past. Switch to the user you want to receive the copy of the mix from another user. <MIXnumber> is the source of the signal defined by the user number. To disable the CUE mode set <MIXnumber> to 0.
- /KLANGfabrik/user/LinkMonitorOutput i <MIXnumber> s <UID>
Clock Source
- /KLANGfabrik/Hardware/ClockSource i <ClockSource> s <UID>
Show Files
Request the list of presets. Answer contains this list as strings.
- /KLANGfabrik/control/RequestListOfPresets
Change preset (system wide, for all mixes). <presetName> must match exactly the name of the preset (case-sensitive) without ending (.xml/KLANGshow).
- /KLANGfabrik/control/presetSelect s <presetName>
Save a preset with a new KLANG show file name
- /KLANGfabrik/control/presetSave b 1 s <presetName> b 1
Snapshots
Take snapshot:
- /KLANGfabrik/control/TakeSnaphot s <SnapshotName>
- /Kf/co/takeSnapshot s <SnapshotName>
Delete Snapshot
by <SnapshotID>. This is is the ID shown in the KLANG:app > CONFIG > PRESET > Snapshot list with the prefix “ID: “
- /KLANGfabrik/control/DeleteSnaphotById i <SnapshotID> s <UID>
Move up Snapshot by ID
- /KLANGfabrik/control/MoveSnapshotUp i <SnapshotID> s <UID>
Move down Snapshot
- /KLANGfabrik/control/MoveSnapshotDown i <SnapshotID> s <UID>
Recall Snapshot by ID
- /Kf/co/recall i <SnapshotID> [s “RecallSafe”, <recallSafeOption1>, <RecallSafeOption2>,…]
Recall Snapshot by Index
This is the position in the current snapshot list shown in KLANG:app. (zero index, the first snapshot has index=0)
- /Kf/co/recallInd i <SnapshotPositionInTheList>
Recall First Snapshot
- /Kf/co/recallFirst [s “RecallSafe” <recallSafeOption1> <RecallSafeOption2>,…]
Recall Next Snapshot
- /Kf/co/recallNext [s “RecallSafe”, <recallSafeOption1> <RecallSafeOption2>…]
Recall Previous Snapshot
- /Kf/co/recallPrev [s “RecallSafe” <recallSafeOption1> <RecallSafeOption2> …]
Update Snapshot
- /Kf/co/updateSnaphot i <SnapshotID>
Without any integer argument, the current snapshot will be used instead:
- /Kf/co/updateSnapshot
Recall Safe Options
Optional: To every command you can append (prior to the UID) the string “RecallSafe” followed by a list of strings including the options that should not be recalled by this command.
- “OutputLevel”
- “Mode”
- “ChannelGain”
- “LocationX”
- “LocationY”
- “LocationZ”
- “ChannelMode”
- “Solo”
- “Mute”
Example:
- /Kf/co/recallNext, ssss, “RecallSafe”, “Mute”, “Solo” ,<UID>
- Recalls the next snapshot but keeps the current solo and mute states.
Configuration Commands
Assign a new name <NEWname> to a mix/user
- /KLANGfabrik/control/RenameUser i <MIXnumber> s <NEWname> s <UID>
Request list of trackers. Answer contains this list.
- /KLANGfabrik/control/RequestListOfTrackers
Change the associated motion tracker <TRACKERuid> for a user
- /KLANGfabrik/control/changeTracker s <TRACKERuid> s <UID>
Additional Commands
Trigger a restart (system will be back to normal after reboot)
- /KLANGfabrik/Hardware/Restart (no arguments)
Set Clock Speed Mode:
- KLANGfabrik/Hardware/SetSRMode i <mode> (requires restart!)
- 1: single speed, 2: double speed
Set EQ mode:
- KLANGfabrik/Hardware/SetEQMode, bool, <mode> (requires restart!)
- true: on, false: off
Set second MADI port input/output:
- /KLANGfabrik/Hardware/SetMadiDirections i 2 b <mode>
- true: (second) input, false: output
Set display brightness. <Brightness> between 0 (off) and 1 (bright).
- /KLANGfabrik/Hardware/DisplayBrightness f <Brightness> s <UID>
Request information as on the INFO screen in the GUI. Answer is an XML file in one single string.
- /KLANGfabrik/Hardware/StatusUpdate
Set number of input channels <NumInputs> and number of users <NumUsers>.
- carefully check the values with the maximum processing power as specified in the table in the manual. Overloading might lead to a device that is not able to be remote controlled. audio might have drop outs.
- /KLANGfabrik/Hardware/SetNumberOfInputsAndOutputs i <NumInputs > i <NumUsers> s <UID>
KLANG:app Remote Control
KLANG:app an be remote controlled from the network on UDP Port 9111.
User Interface Commands
Switch to Fader-View
- /Ka/screen/FADERS1
Switch to Group-View
- /Ka/screen/FADERS2
Switch to Stage-View (Orbit)
- /Ka/screen/STAGE1
Switch to Stage-View (Landscape)
- /Ka/screen/STAGE2
Switch to Meters-View
- /Ka/screen/METERS
Switch to Config-View (Last page that was selected)
- /Ka/screen/CONFIG
Change User
- /Ka/screen/user i <userID>
Connect to KLANG processor
- /Ka/control/connect s <remoteAdress> i <userID>
Change App User-Mode (MUSICIAN = 10, PMM = 20, TECHNICIAN = 30, ADMIN = 40)
- /Ka/control/mode i <mode>
Further Commands
Set Serial Number: /KLANGfabrik/Hardware/Serial s <8digit SN starting with K…>
Set Unit Name: /KLANGfabrik/Hardware/UnitName s <UnitName>
