Sending metadata from Metadata2 to Amperwave using Metadata1

  • Published on Dec 31, 2024
  • 3 minute(s) read
  • Migration Team

Unlike Triton, Amperwave uses a pure Icecast method for sending stream audio and metadata. This document will cover the steps needed to get your metadata that is already received by Metadata2 and get it over to the Icecast metadata.

Metadata is already processed, received, translated, and delayed (PDM). In an effort to maintain the current Triton configuration we will pick up this data from the PDM and hand it off to Amperwave. There are two steps to accomplish that.

  • Create a new Output in Metadata2 with the from PDM Data and output to Metadata1

  • Add a Metadata1 configuration with a new lua filter for Icecast.

You will need to duplicate these steps for each station on your Z/IPStream R2

  1. Launch Metadata2

  2. Click Outputs from the menus across the top and choose, Send output over TCP

  3. Complete the configuration of the output

    1. Supply a display name.

    2. Select a source. The source should be the currently configured TCP Client that receives the metadata from your PDM.

      Note that the Type will show TCP Cli and (in our case) it's named WWBXHD2 from PDM.

    3. Select the Template Send to PDM. This must use Send to PDM in order to match up with the filter we'll create in the next steps.

    4. Leave Code page set to <>

    5. Set the Destination address/port. In this case, the address will always be 127.0.0.1, and the port used (9999 in this example) just needs to be unique to the Z/IPStream R2, meaning it can not be duplicated in any other configuration for the entire R2.

    6. Click OK

The final new output should look like this.

An updated filter is required for the Metadata1 configuration. Click here to download the Amperwave.lua filter and save it to a location on your computer.

  1. Using a Web Browser, log in to the main Web Page of your Z/IPStream R2

  2. Click Metadata on the main menu across the top of the home page

  3. On the Metadata page, click Manage Filters in the menu across the top

    You are on the Manage Metadata Filters page.

  4. On the Manage Metadata Filter page, click the Upload button.

  5. When the browser window appears, locate and select the Amperwave.lua filter you downloaded at the beginning of this section.

You will see a message that says, "Preset file has been successfully uploaded!" and the Amperwave filter will show in the list of filters.

  1. Return to the main metadata menu by clicking Metadata on the menu across the top

  2. From the Add Metadata Source drop-down list, select TCP on specific port

  3. Supply a Friendly Name.  In this example, "KBRY Amperwave"

  4. Specify the Local port to accept TCP connection: (this must be the same port specified in the Metadata2 output configuration from above, in this case, 9999)

  5. Select the new Amperwave filter from the Metadata Filter drop-down list.

  6. Click Save

Your new Metadata source is shown in the list.  Repeat these steps for any additional stations on this unit making sure to use unique TCP ports for each station.

  1. Return to the main menu by clicking Main in the menu across the top

    This new metadata source must be applied to each stream you send to Amperwave

  2. Click the Edit (Pencil) icon for the first instance you need to configure

  3. From the Streams: list, select the first stream to edit, then click the Edit stream button keeping in mind there may be more than one stream.  Each stream must have metadata applied.

  4. Click the Metadata source drop-down list and select the newly created Metadata Source

  5. Make sure to click Save at the BOTTOM of this page. Clicking Save above will not save your work.

  6. Finally, click Save at the TOP of the page.

  7. Repeat these steps for any additional streams.

Verification of metadata can be seen in the Media Encoder logs.

  1. From the Main menu, click on Status

  2. Click on Logs

    There are many different types of logs in the Z/IPStream R2. Media Encoder logs are the first set of logs in the list.

  3. Click on the name of the most recent log under the Media Encoder heading. It's normal for the current days log to show "0 B"

Logs may be downloaded and viewed off-line by clicking the [gzip] link to the right of each logs file.  

  1. Scroll to the bottom of the log and look for a line that starts with "Send metadata to ICEcast Server at..."

The lines that follow in the log will show both the Title (URL encoded) and the Url (URL encoded). If the data is sent correctly you will see a message in the log that says, "Reply from ICEcast server...." and should show an HTTP response of "200 OK"

Related articles