An NMOS Client in JavaScript

Introduction

This repository contains a client implementation of the AMWA Networked Media Open Specifications in JavaScript, licensed under the terms of the Apache License 2.0.

• AMWA IS-04 NMOS Discovery and Registration Specification
• AMWA IS-05 NMOS Device Connection Management Specification
• AMWA IS-08 NMOS Audio Channel Mapping Specification (read-only for now)
• AMWA BCP-004-01 NMOS Receiver Capabilities

For more information about AMWA, NMOS and the Networked Media Incubator, please refer to http://amwa.tv/.

The repository structure, and the external dependencies, are outlined in the documentation.

Getting Started With NMOS

The Easy-NMOS starter kit allows the user to launch a simple NMOS setup with minimal installation steps. It relies on nmos-js to provide an NMOS Client that works with an NMOS Registry and a virtual NMOS Node in a Docker Compose network, along with the AMWA NMOS Testing Tool and supporting services.

Getting Started For Developers

Easy-NMOS is also a great first way to explore the relationship between NMOS services.

The nmos-js codebase is intended to work with any NMOS Registry, but can take advantage of the features of the nmos-cpp implementation.

After setting up the dependencies, follow these instructions to build and deploy the nmos-js client itself.

The web application can also be packaged and deployed with the nmos-cpp-registry application. Copy the contents of the nmos-js build directory into the admin directory next to the nmos-cpp-registry executable.

Agile Development

The nmos-js client, like the NMOS Specifications, is intended to be always ready, but steadily developing. The nmos-js client works as both an NMOS Registry browser, using the IS-04 Query API, and provides connection management, using the IS-05 Connection API. When used with the nmos-cpp-registry, it also provides access to registry log messages. It has been successfully tested in many AMWA Networked Media Incubator workshops, and in the JT-NM Tested programme.

Recent Activity

The implementation is designed to be extended. Development is ongoing, following the evolution of the NMOS specifications in the AMWA Networked Media Incubator.

Recent activity on the project (newest first):

• Read-only support for IS-08 Audio Channel Mapping
• Support for BCP-004-01 Receiver Capabilities
• JT-NM Tested 03/20 badge (packaged and deployed on a Mellanox SN2010 Switch)
• Improved and simplified connection management
• Periodic refresh
• Lots of other incremental improvements
• Added support for multi-homed Nodes
• Added connection management support for RTP, WebSocket and MQTT transports
• Added a dark theme
• Switched to react-admin framework from ng-admin

Contributing

We welcome bug reports, feature requests and contributions to the implementation and documentation. Please have a look at the simple Contribution Guidelines.

Thank you for your interest!