This document describes how to use tRio via a web-browser. Click here for instructions on how to use it via the Front Panel and Remote Control and here for the thin front-end.

Getting Started

To start the web-based front end, point your web-browser to the following address:


where xxxx is either the ip address or host name of the machine that is running the tRio server.

If this does not work, see the trouble shooting section below.

The Navigation Panel

The panel on the left of the applet lists the Rio Receivers that are or have been connected to the tRio Server:

The Status Tab

Each Receiver has a Status Tab which shows its connection status and allows you to:

Playing Music

When a unit connects a Player tab appears next to the Status tab:

Queue 'n Play Mode

In Queue 'n Play mode, the Artist, Album, Genre and Playlist tabs are used to add tunes to the Play Queue. These can then played with various repeat and random settings.

  • Press the Expand and Collapse buttons to show or hide the entries under the Selected Artist, Album, Artist, Genre or Playlist.
  • Press the Add and Remove buttons to add or remove all the entries under the selected item to the Play Queue.
  • Press the Refresh button to rebuild the list from the server.
  • Double clicking a tune will add it to the Play Queue. Double clicking any thing else will expand or collapse it.

The Queue tab shows the contents of the Play Queue and allows you to skip directly to a particular entry:

  • The currently playing entry is indicated with an icon. Otherwise the position in the queue is shown.
  • Press the Remove button to remove the selected item from the Play Queue. Playback will stop if the item was being played.
  • Press the Clear button to remove all tunes from the Play Queue.
  • Press the Play button to start playing the selected item.
  • Use the Up and Down buttons to reorder the tunes in the Play Queue.
  • Double clicking an item will start playing it.

Jukebox Mode

Jukebox mode allows you to position yourself anywhere within your music collection and start playing from there onwards. Powerful Repeat and Random modes allow you to repeat within the current Genre, Artist, Album or Tune.


The Artist tab presents your collection by Tune within Album within Artist. The Genre tab presents Tune within Album with Artist within Genre.

  • Double click a Genre, Artist or Album will expand or collapse it..
  • Press Play on an item to start playing with first tune beneath it.
  • Press the Refresh button to rebuild the list from the server.


The following Repeat Modes are supported:

Genre Repeats all tunes within the current genre.
Artist Repeats all tunes within the current artist.
Album Repeat all tunes within the current Album
Tune Repeats the current tune endlessly
All Repeats the entire music collection


If Random Mode is on then the next tune to be played will be chosen at random from within the Repeat scope.

Radio Mode

Radio mode allows you to tune into SHOUTcast internet radio broadcasts.

  • Double click or press the Play button to start listening to the selected station.
  • Use the New, Edit and Delete buttons to add, modify or remove radio stations from the list.

When adding or editing a station, specify the URLs what appear when you hover the mouse over the on The URL are in the format:

Alternatively you may be able drag the from and drop these onto the Player tab.

Listen Mode

Listen mode allows you to synchronise playback between multiple Receivers.

  • Press Listen to start synchronised playback with the selected player (if available).

The availability of the Receivers in the Listen To tab is indicated by the following icons:

not connected the Receiver cannot be synchronised because is not currently connected to the tRio server.
not accesible the Receiver cannot be synchronised because it is on a different network.
circular the Receiver cannot be synchronised with because it is listening to this unit
standby the Receiver cannot be synchronised with because it is in Standby mode
private the Receiver cannot be synchronised with because its access level is set to Private
protected the Receiver can be synchronised with, but not controlled by this Receiver
  public the Receiver can be both synchronised with and controlled from this Receiver


Getting "The page cannot be displayed" error.
  1. Check that the tRio Server is running.
  2. Check that the xxxx part of the address points to the correct host name or ip address.
  3. Check that you have not missed out the :8090 part of the address.
  4. Check for the "Warning: LocalHost lookup failed" message in the tRio console (see below).
Getting "Applet failed to initialise" error.

Ensure that you have installed Java 1.4.2 as the default plug-in for your web browser.

This can be confirmed by looking at the very 1st line in the java console (accessed via the coffee mug in the System Tray). It should read:

Java(TM) Plug-in: Version 1.4.2


Drag and Drop not working for from
  1. Ensure that you are dragging the icons and not the station descriptions.
  2. The stations must be dropped into the Player tab.


WARNING: LocalHost lookup failed. You may experience problems connecting via the Web font-end. Please specify the host-name in trio.xml.

If this message appears in the tRio console then change the following line in trio.xml:

<rmi create-registry="true"/>


<rmi create-registry="true" host-name="xxxx"/>

where xxxx is either the host name or ip address of the machine that the tRio server is running on.

Advanced Configuration

The following attributes can be edited in trio.xml to change the defaults used the the web front-end.

WARNING: Do not change these values unless you know what you are doing.

Attribute Parent Element Description Default
port http-server the port on which the tRio http server runs 8090
root http-server the root used for locating documents, archives and images the tRio install directory
create-registry rmi whether tRio should start its own RMI registry on not true
host-name rmi the host name to be used when binding the RMI service the local machine's host name
port rmi the port on which the RMI registry will run 1099 (java default)