Skip to main content

Connecting Blockz to iNews

Step-by-step setup guide for broadcast engineers connecting Blockz to Avid iNews via MOS protocol, including Automator configuration and connection verification.

Before you start

To connect Blockz to iNews you will need:

  • Access to your Cuez Blockz organization

  • An iNews system administrator present, or performing the NRCS-side steps themselves. These steps touch core NRCS configuration.

  • iNews (tested with iNews 2023)

Installation order:

  1. Blockz

  2. NRCS MOS gateway configuration (iNews)

  3. Cuez Automator

Step 1 - Configure the Blockz plugin

1. Log in to your Cuez Blockz organization via blockz.cuez.app (or us.blockz.cuez.app, depending on your region), and log in if prompted.

2. Select the Blockz Repository needed for this installation.

3. Click MOS in the bottom left of the screen. A popup will show up.
​


​4. Fill in the fields:

Field

Description

NRCS

Select iNews from the dropdown

Plugin appearance

Choose light or dark mode for the plugin

MOS ID

The MOS ID you will set when connecting the Automator (Step 3). Default: CUEZAUTOMATOR.MOS

Default MOS channel

Set per your NRCS configuration

Cue Block Placement

Set per your production workflow

Auto-Load Cue block on Story change

When switching stories in iNews, automatically navigate to the first Blockz MOS object in that story

Auto-update rundown on edit

Automatically update the MOS object when the plugin data changes

5. Fill in all fields, then click Create API Key. Copy the URL shown in the dialog.

Save this: copy the HTML Plugin URL. You need it in Step 2, prefixed with URL=.

Step 2 - Configure Blockz in iNews

Technical setup: the NRCS system administrator must be present or perform these steps themselves.

2.1 Add the Blockz HTML plugin in iNews

Log in to iNews. Go to SYSTEM.MOS-MAP and add the following device entry:

CUEZAUTOMATOR.MOS   CUEZAUTO

2.2 Add the MOS device in mosconfig.xml

  • The mosconfig.xml file can be found in C:\Program Files (x86)\Avid\iNEWS MOS Gateway.

  • The MOS parameter is the MOS ID from Step 1, the same as used in the Blockz repository.

  • The NETWORK parameter is the hostname of the machine running the Cuez Automator. This must be a hostname, an IP address is not sufficient. Make sure the hostname resolves correctly in DNS, otherwise adjust the hostfile on the MOS Gateway device.

  • The AMCP value comes from SYSTEM.MOS-MAP.

2.3 Add the plugin to SYSTEM.HTML-PLUGINS

  • Go to SYSTEM.HTML-PLUGINS.

  • Add a new entry or story.

  • Paste the following into the story, replacing [URL PLACEHOLDER] with the URL you generated in Step 1:

URL=[URL PLACEHOLDER]://data from MOS item contentmosItemBrowserProgID=blocks.browsermosItemEditorProgID = CUEZAUTOMATOR.MOS
  • You can ignore mosItemBrowserProgID and mosItemEditorProgID.

  • Press CTRL + S to save, then restart the iNews client.

2.4 Add the Automator to the monitor of the rundown

  • Go to SYSTEM.MAP.

  • Search for the rundown you want the Automator to be loaded on.

  • Add the following line to that rundown:

mos   CUEZAUTO   -   storytext
  • Press CTRL + S to save, then restart the client.

Step 3 - Connect the Automator to your NRCS

  1. Download the latest stable or beta build from download.cuez.app.

  2. For the initial Automator installation, see Network requirements below for where to install it.

  3. Pair a new project to the Automator and fill in the fields:

Field

Description

Name

A recognizable label for this connection in your rundown list

NRCS

Select iNews from this dropdown

MOS Device ID

The name this MOS device uses to identify itself in iNews. Default: CUEZAUTOMATOR.MOS. Note this down, you need it in Step 2.

Newsroom NCS ID

The identifier your NRCS uses on the MOS connection. Get this from your system administrator or the NRCS settings.

Newsroom Host

IP address of the iNews server

Enable dual-peer failover

Check this box to connect to a backup newsroom on the same ports and fail over automatically when the primary goes down

Secondary NCS ID

The identifier the buddy NRCS uses on the MOS connection, if using dual-peer failover. Leave blank to reuse the primary Newsroom NCS ID

Secondary Newsroom Host

IP address of the buddy NRCS server, if using dual-peer failover

Lower Port

Prefilled: 10540

Upper Port

Prefilled: 10541

Blockz Repository

Select your region, e.g. Blockz EU or Blockz US

Repository ID

Log in to Blockz and copy the ID from the browser address bar

Repository API Key

In Blockz, go to Settings > API Key (bottom right). Create a new key with a recognizable name (e.g. "Automator") and paste it here

When all fields are filled in correctly, green checkmarks appear left of each field. Click Submit. The Automator opens the list of all rundowns available via MOS.

Result: Blockz, your NRCS, and the Automator are now connected. Start building automations in the Automator.

Network requirements

Where to install the Automator

The Automator is a small application that runs as a service, in the tray on Windows or the menu bar on Mac. It can be installed on a separate computer, or on the same machine running your playout software (vMix, NewBlue, or similar). Whichever machine you choose, it needs a network position that satisfies two requirements at once:

  1. Reachable from the NRCS MOS Gateway. The Automator talks MOS directly to the iNews MOS Gateway server. Place the Automator on a machine that has clear network access to that server: same subnet, or routed with the required ports open (10540/10541 for MOS, plus any ports you configure in Step 3).

  2. Able to reach the studio devices. Automations only fire if the Automator can talk directly to the devices it controls: vision mixers, graphics systems, cameras, audio, playout. Make sure firewalls and VLANs do not block the Automator from reaching each device's control IP and port.

Requirement

Detail

Internet connection

Required for the Automator app itself

Local port

7070, used to access the Automator GUI (default: 127.0.0.1:7070). You can change this port in the Automator UI if needed

Media storage

Downloaded media (script and rundown assets) is stored in a location you define: the Automator machine, the playout machine, or separate storage

When installation is done, open a browser (Chrome preferred) and go to the Automator's IP and port, or click Open GUI. On first run, give the Automator a name, then pair it with your project as described in Step 3.

Troubleshooting

How do I make a rundown MOS active?

Open the Running Order and select MOS Control Active.

Rundown does not appear in the Automator

Check the MOS Story Send status for the rundown, and confirm the story is included in the send list.

iNews does not connect to the Automator

Confirm the MOS configuration (SYSTEM.MOS-MAP and mosconfig.xml) has the correct hostname for the Automator, and that the hostname resolves in DNS.

Plugin does not appear after adding SYSTEM.HTML-PLUGINS

Restart the iNews client to load the newly configured plugin.

What producers can do once connected

Once connected, producers can insert Blockz cue blocks into any iNews story using the plugin. For full instructions on the producer workflow, see The Blockz iNews plugin - filling in blocks and adding them to stories.

Did this answer your question?