Using WatchFile2Tcp Utility to send metadata

Updated by Bryan Jones


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


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

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 in 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 instance, you could specify WXYX.txt if you need to be exact.
  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 file's entire contents.

Additional Setup Information

Configuration data for the WatchFile2TCP program is automatically stored in the WatchFile2TCP.cfg file in the same directory.

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

If the user cannot 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?