=============================================================================
        Installation and first run
=============================================================================

Download and save ftusbrdp-*.tar.gz and ftplugins-*.tar.gz.
Unpack archives to the /opt:

  tar -zxf ftusbrdp-*.tar.gz -C /opt
  tar -zxf ftplugins-*.tar.gz -C /opt

To run the automated setup script your OS should have systemd, which most
modern Linux distributions include. Run the setup script with -i or --install
option and it will do the rest:

  $ sudo /opt/ftusbrdp/bin/ftusbrdp-setup.sh -i

Alternatively, you can start the daemon manually. You must run it as a root:

  $ sudo /opt/ftusbrdp/sbin/ftusbrdpd -d

or:

  $ su -c "/opt/ftusbrdp/sbin/ftusbrdpd -d"

To see the list of all supported options, run:

  $ /opt/ftusbrdp/sbin/ftusbrdpd -h

Daemon settings initialization can be done with a configuration file. Further
daemon management can be done via the graphical user interface application or
command line utility.

=============================================================================
        Graphical User Interface Application
=============================================================================

GTK 3 is required.

If the program was installed using the setup script, you can launch it in
the usual way. Just click on USB for Remote Desktop Workstation in your
applications menu.

Alternatively, to launch the application from the terminal, run:

  $ /opt/ftusbrdp/bin/ftusbrdpgui
  
=============================================================================
        Command Line Utility
=============================================================================

Run the command line utility:

  $ /opt/ftusbrdp/bin/ftusbrdpctl <command> [options]

To see the list of all supported commands, run:

  $ /opt/ftusbrdp/bin/ftusbrdpctl help

To see the list of the devices available:

  $ /opt/ftusbrdp/bin/ftusbrdpctl list 
  ID         VID: PID: REV           Location  Device name and status 
  107        07d1:3c03:0001               1-2  802.11 bg WLAN /Shared/ 
  202        046d:c045:2730               2-1  USB Optical Mouse /Unshared/

Here the columns are:

  ID - unique device identifier 
  VID:PID:REV - device hardware identifier (vendor ID, product ID, revision)
  Location - USB device topology (can be "unknown" if your system cannot
             report the device topology)
  Device name and status  - displays the name of the device and its current
             status (shared/unshared/connected)

You can share the device by its unique ID (an example below shows how to
share USB Optical Mouse from the list above):

  $ /opt/ftusbrdp/bin/ftusbrdpctl share 202

NOTE: Sharing by the device ID allows you to share separately one of the
devices that have identical VID:PID:REV.

To unshare the device use "unshare" command with the same syntax as "share":

  $ /opt/ftusbrdp/bin/ftusbrdpctl unshare 202

=============================================================================
        Configuration File
=============================================================================

See the configuration file usage details in the default configuration file
"ftusbrdp.conf" that is included in the product package.

To import settings from configuration file, start daemon with '-i' option:

  $ sudo /opt/ftusbrdp/sbin/ftusbrdpd -i ftusbrdp.conf

Alternatively, to reinitialize daemon, you can use command line utility:

  $ sudo /opt/ftusbrdp/bin/ftusbrdpctl import ftusbrdp.conf

To export current daemon settings to configuration file:

  $ /opt/ftusbrdp/bin/ftusbrdpctl export ftusbrdp.conf

=============================================================================
        Remote Desktop Session
=============================================================================

Appropriate version of FreeRDP should be installed. Then run once:

  $ sudo /opt/ftplugins/bin/ftrdpbr-setup.sh -i

There are 2 ways of usage.
First, just launch:

  $ /opt/ftplugins/bin/ftlaunch

Second, use FreeRDP directly. It depends on the installed FreeRDP version:

  FreeRDP v1.1, v2.0 and above:
    $ xfreerdp /dvc:ftrdpbr /u:USER /p:PASSWORD /v:SERVER

  FreeRDP v1.0:
    $ xfreerdp --plugin ftrdpbr -u USER -p PASSWORD SERVER

=============================================================================
        Citrix Session
=============================================================================

Citrix Receiver should be installed. Then run once:

  $ sudo /opt/ftplugins/bin/ftctxbr-setup.sh -i

There are 3 ways of usage.
First, use a web browser with XenServer address:

  http://SERVER/

Second, run the Citrix Receiver directly:

  $ /opt/Citrix/ICAClient/selfservice

Third, if /opt/Citrix/ICAClient/config/appsrv.ini was edited, run:

  $ /opt/Citrix/ICAClient/wfica

=============================================================================
        Omnissa Horizon Session
=============================================================================

Omnissa Horizon Client should be installed. Then run once:

  $ sudo /opt/ftplugins/bin/ftpcoipbr-setup.sh -i
  $ sudo /opt/ftplugins/bin/ftblastbr-setup.sh -i

Start Omnissa Horizon Client.

=============================================================================
        Teradici PCoIP Session
=============================================================================

Teradici PCoIP Client should be installed. Then run once:

  $ sudo /opt/ftplugins/bin/ftpcoipbr-setup.sh -i

Start Teradici PCoIP Client.

=============================================================================
        Amazon PCoIP Session
=============================================================================

Amazon WorkSpaces Client should be installed. Then run once:

	$ sudo /opt/ftplugins/bin/ftpcoipbr-setup.sh -i

Start Amazon WorkSpaces Client.

=============================================================================
        Amazon NICE DCV Session
=============================================================================

Amazon WorkSpaces or NICE DCV Client should be installed. Then run once:

	$ sudo /opt/ftplugins/bin/ftdcvbr-setup.sh -i

Start Amazon NICE DCV Client.
