Using WatchFile2Tcp Utility to send metadata

Updated 5 months ago by Bryan Jones


This document covers the use of the WatchFile2TCP utility for reading a text file and sending the contents by TCP to your streaming product.


All Telos streaming products accept metadata through TCP/IP connection. Some automation systems are not able to send metadata over TCP/IP; they can only generate an output file with the currently playing song. The WatchFile2TCP utility was created to address this situation. The utility application watches a specified directory for file changes. When a change is detected, the application sends the file contents over a TCP/IP connection to Omnia A/XE.

Using WatchFile2TCP

WatchFile2TCP utility is included with many streaming products but can be downloaded here and saved to any location on your computer.

  1. Double-click the WatchFile2TCP.exe file to start the application. The following application window will be displayed:
  1. Fill in the directory or browse for the location where the file will be stored
  2. Fill the file mask that the application should use when watching for changes.
In this example, we are looking for ANY FILE (the *) ending in .txt. You can be as specific as you need. For example, you could specify WXYX.txt if you need to be specific.
  1. In the “Destination address” field, enter the address and port that has been configured in your streaming software to receive the metadata information.
  2. Click the Start button.

Each time a file modification is detected the Status field will show the change and send the entire contents of the file.

Additional Setup Information

When you exit the application, the configuration data is saved to WatchFile2TCP.cfg, stored in the same directory as the application.

All changes detected are written to a WatchFile2TCP.log file also stored in the same directory as the application.

If the user does not have the ability to write to the current application folder, WatchFile2TCP.exe should be moved to a folder where the user does have write rights.

To start the program automatically add the -run option. If you have placed a shortcut in your Windows Startup, modify the Target as shown here.

You must configure and exit the program once so that the WatchFile2TCP.cfg file is created, or the -run option will not work.

Let us know how we can help

If you have further questions on this topic or have ideas about how we can improve this document, please contact us.

How did we do?

TelosHelp (opens in a new tab)

Powered by HelpDocs (opens in a new tab)