TRx Software Integration API

TRx can be controlled by other programs. For example other software can start or stop recording or add data to the recorded wav files. This is useful for creating automation systems or linking TRx to customer management systems.

This information is intended for programmers only.

Overview
We have attempted to make controlling TRx from within your programs to be as simple as possible and available from many languages, the command line and even telnet if required.

It is controlled by running the trx.exe with arguments. TRx will automatically detect if it is already running and process the arguments correctly - you will not end up with multiple instances of TRx.

For testing purposes you can execute TRx commands from the command line. From most programs you would control trx using the WinExec command and specify the correct path to the exe like this in C++...

WinExec( "\"C:\\Program Files\\NCH Swift Sound\\TRx\\trx.exe\" -record", SW_SHOWNORMAL ); Because there is a space in the path name it is important to include it between "".


Locating trx.exe
After you have run the setup file trx.exe will be located in: C:\Program Files\NCH Swift Sound\TRx\trx.exe


Commands
-record

This starts recording.

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -record -record "Data"

This starts recording but adds the argument Data in the file name for reference and searching. Use this if your software has a customer reference number to link the recording to.

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -record "REF1002391" -hold

This starts playing the hold message.

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -hold -stop

This stops recording (or if on hold takes it off hold).

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -stop -data "Data"

This sets the recording data for the next time the user manually presses record. If the user is going to manually start recording your software can call this to provide data whenever the user opens a customer file for example. Then when recording is later started manually the data is used.

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -data "REF1002391" The data can be cleared by omitting it like this... "C:\Program Files\NCH Swift Sound\TRx\trx.exe" -data -exit

This closes TRx (complete exit).

"C:\Program Files\NCH Swift Sound\TRx\trx.exe" -exit to open TRx at any time use simply... "C:\Program Files\NCH Swift Sound\TRx\trx.exe"


Problems
If you have any problems with the above you can contact us using the form at Technical Support Questions and Contacts.

We also accept suggestions for new features at www.nch.com.au/suggestions.


Licensing and Reseller Arrangements
Every user of TRx must be licensed.

If you want to sell TRx as part of your software application you should consider the OEM Blanket license see www.nch.com.au/reseller which for a flat monthly fee gives you unlimited licenses with your product.