This article is part of a series on WideOrbit.
To work through this installation process for the first time, please contact Futuri VIP Support. A remote session with one of our Support Agents should take about 30-60 minutes per station.
This process includes the following steps:
WideOrbit Information Gathering
In order for Echo to be configured to interact with WideOrbit's API, we'll just need the following information:
- Name of the WideOrbit central server (can either be an IP or a name)
- Name of the station on that server (case-sensitive, typically WXYZ-FM or something similar)
Echo can be installed either directly on the Central Server or on another PC (as long as it can see both the CS and the internet).
You may also want to check your category definitions in your WideOrbit admin to make sure that ONLY song categories are configured as "music." It is helpful to provide a list of these categories to Futuri VIP Support as well.
There are three basic functions of Echo on WideOrbit stations:
- Now Playing information - Song elements and a few select Memos will be configured to export from WideOrbit to Futuri.
- Voting session integration - WideOrbit's API has built-in integration for Tether, and we'll configure Echo to communicate with WideOrbit for this information.
- Music Logs- Echo will also periodically send Futuri a copy of the day's WideOrbit log. These logs are used for two primary purposes:
- Voting Sessions - Depending on the voting feature your station uses, music logs help to tell Futuri what the vote options should be (or to see what songs should be used for separation purposes).
- Instant Alerts - Users can sign up to receive alerts when their requests are about to play on your station. Futuri's system compares what your station is playing now with what's scheduled in the near future so that we can send these alerts ahead of when the request actually plays (so there's time for the user to turn on the radio).
Echo should generally be downloaded from here and you can obtain settings files (named station.xml and wideorbit.xml) from Futuri VIP Support. Do not run Echo.exe without first configuring the station.xml and wideorbit.xml files.
To install Echo (typically on the station’s CS, but not necessarily), create the folder C:\Echo\XXXX (where XXXX is the station’s call letters) and extract the contents of the downloaded Echo.zip (link above) to the same folder. If you are setting up multiple stations, each should have a folder in C:\Echo (with its own Echo files inside).
In the newly extracted folder, place the station.xml and wideorbit.xml files from Futuri VIP Support. These settings files must be saved in the same folder as Echo.exe.
When finished configuring, save wideorbit.xml and repeat steps as needed for other stations. Each station will need its own copy of Echo.
Note: Microsoft .NET 4.0 or higher is required for Echo. If you're running Windows 7 or higher, you should be all set, but If needed, you can download .NET 4.0 by clicking here and following the instructions. When .NET 4.0 is confirmed to be installed, run Echo.exe and navigate to File > Boot on Startup so that Echo will start up with the PC.
Once the steps above have been completed and Echo is running, make sure that there are no noticeable errors on Echo’s screen.
Make sure that the next song played in WideOrbit is received by Echo.
To test the winning song check-in process, you can place a Memo in WideOrbit called "Empty Song Slot". Within 30 seconds, Echo should show a message indicating that it's requesting a winning song from Futuri. The Memo will be replaced by that song 30-60 seconds before the Memo's ETA, so if you don't want to actually play a winning song during your test, you'll need to delete the Memo (or the inserted song).
To test the music log push process, you can navigate in Echo to WideOrbit > Send Schedule to LDR > Today. It is normal to see some benign errors on the screen after that, and Futuri VIP Support can confirm whether the log was successfully received.