EasyManua.ls Logo

Mechdyne Corporation TGX - User Manual

Default Icon
22 pages
Print Icon
To Next Page IconTo Next Page
To Next Page IconTo Next Page
Loading...
TGX
User Guide
Version 2.2
Mechdyne Corporation
June 2021
Question and Answer IconNeed help?

Do you have a question about the Mechdyne Corporation TGX and is the answer not in the manual?

Overview

The TGX system is a remote desktop protocol designed for power users such as designers, engineers, scientists, and creatives who work with graphic-intensive applications, large data sets, and require high-resolution data visualization. It facilitates remote access to powerful workstations, whether physical, virtual, or cloud-based, across an enterprise. TGX supports workforce mobility, allowing users to connect from various locations like offices, homes, conference rooms, partner sites, or even remote fields. It also enables multi-user collaboration, connecting teams locally or globally with a "like-local" experience to enhance productivity.

The TGX system operates with two main components: a TGX sender and a TGX receiver. The TGX sender is installed on the remote workstation running powerful applications, typically located in an office, data center, or the cloud. The TGX receiver is installed on the user's local device, such as a laptop, desktop computer, or thin client. The sender transmits video and audio to the receiver, while the receiver provides control inputs via keyboard, mouse, or USB devices.

Technical Specifications and Features:

Connection Initiation:

TGX connections are always initiated by the receiver to the sender. The sender passively listens on a default port for connection requests. The receiver must be able to reach the sender via hostname or IP address, which may require both computers to be on the same network, connected via a Virtual Private Network (VPN), or using a third-party Gateway for port forwarding.

TGX offers three methods to initiate a connection:

  • TGX Launcher GUI: A graphical user interface application installed on the receiver.
  • TGX Connection File: A file with a '.tgx' suffix containing necessary session information, allowing connection without the Launcher GUI. These files can be manually created as desktop icons.
  • Third-party Connection Broker: Integration with TGX using a connection file, often used with software like Leostream or DELFI.

TGX Launcher Application:

The TGX Launcher GUI is used to initiate TGX connections. It can be accessed from the desktop icon on Windows (under Applications -> Internet -> Mechdyne TGX on Linux, and Open Finder -> Applications on Mac).

When launching, users can specify:

  • Computer: The hostname or IP address of the remote computer running the TGX Sender. A dropdown list stores previously visited senders (up to 10).
  • Display Settings: Users can define the sender's desktop layout, including the number of displays, resolutions, and positions. Options include:
    • Match All monitor(s): The sender desktop is reconfigured to match all monitors of the receiver.
    • Match selected monitor(s): Users visually select specific monitors using the Launcher GUI. If the sender's desktop is larger than the receiver's visible region, the MiniMap will appear, allowing the user to select the portion of the desktop to display.
    • Use Sender's monitors: The existing desktop configuration on the sender is used.
  • Start TGX full screen: Launches TGX in full-screen mode. If unchecked, TGX starts in windowed mode.
  • Other settings: Includes an image quality slider (range 4-100, default 68). Higher image quality increases bandwidth usage and may reduce frame rates on constrained networks. Image quality can only be adjusted when initiating a new TGX session.

Connection Options (from the Connect button):

  • Connect: Default action to start a TGX session.
  • Connect with debug logging: Initiates a connection with debug logging enabled.
  • Get Logs: Collects sender and receiver logs into a ZIP file for troubleshooting, requiring user authentication on the sender.

Authentication:

After clicking Connect, an authentication dialogue prompts for login credentials (Login and Password) to access the remote desktop.

TGX Receiver Application:

Upon successful connection, the TGX Launcher GUI is replaced by the TGX Receiver GUI, displaying the sender's desktop according to the selected view mode and remote display settings. The Receiver GUI includes a graphical area for the sender's desktop and a Toolbar. Input (keyboard, mouse) is sent to the sender when the mouse is within the graphical area. Moving the mouse outside allows interaction with the local PC. The Toolbar drops down from the top of the screen if not visible.

The Receiver GUI displays information such as the Username, Sender hostname, Sender desktop resolution, current bandwidth, current framerate, and TGX version. In windowed mode, the window can be moved and resized.

MiniMap:

If the sender desktop is larger than the TGX Receiver window, the MiniMap becomes visible, illustrating which portion of the sender's desktop is currently displayed. Users can left-click and drag within the MiniMap to select a different region. Right-clicking and dragging moves the MiniMap itself. A toggle button on the Toolbar shows/hides the MiniMap. The MiniMap is unnecessary and hidden in "Scaled to Fit" mode or when resolutions match.

View Modes:

The TGX Receiver supports various view modes:

  • Maximize: Expands the TGX Receiver application to maximize mode, adhering to standard OS conventions. Shortcut: Ctrl+Alt+M.
  • Restore: Returns the TGX Receiver application to windowed mode. Shortcut: Ctrl+Alt+W.
  • Full-Screen: Expands the TGX Receiver application to cover one monitor on the receiver computer. Shortcut: Ctrl+Alt+S.
  • Multi-Screen: Expands the TGX Receiver application across more than one monitor on the receiver computer. Only available if the receiver has more than one monitor. Shortcut: Ctrl+Alt+D.

TGX Toolbar:

The TGX toolbar is visible in windowed or maximized modes, and collapses upward in full-screen or multi-screen modes until the mouse is moved to the top of the screen. It displays current bandwidth usage, frame rate, and provides options for USB redirection, view mode, resolution mode, and MiniMap visibility.

Options Menu (from the TGX icon on the left of the toolbar):

  • Ctrl+Alt+Del: Sends the Windows lock screen or Task Manager command to the sender.
  • Enable Input: Toggles keyboard/mouse input to the sender. Default is enabled (blue highlight). Disabling input (removes blue highlight) is useful during collaboration to prevent inadvertent control.
  • Enable Large Clipboards: Enables synchronization of clipboards up to 32MB (default is 1MB). Requires IT group configuration.
  • Enable keyboard shortcuts: Toggles the availability of keyboard shortcuts for window mode states.
  • About: Displays dialog box with version information.
  • Audio volume slider: Controls audio volume from the sender. Only displayed if the sender and receiver have necessary hardware/software support.

Framerate Control:

The target framerate can be adjusted (24 Hz, 48 Hz default, 60 Hz max). Lower frame rates use less bandwidth but may impact image quality.

Resolution:

  • Full Resolution: Displays the sender's remote desktop at a 1:1 pixel mapping. TGX sessions initially open in this mode.
  • Scaled to Fit: Scales the sender desktop to fit within the TGX Receiver window without changing the aspect ratio, potentially resulting in black bars if aspect ratios differ.

Closing TGX Session:

The X icon in the upper right corner prompts to Disconnect or Log Out.

  • Disconnect: User remains logged into the sender, applications remain open, and the sender screen is locked. User can reconnect later.
  • Logout: User is logged out of the sender, all applications close, and sender returns to the login screen. Not available when connected as a collaborator.
  • Cancel: Continues the TGX session.

USB Redirection (Windows to Windows only):

TGX supports redirecting USB devices from the receiver to the sender, primarily for Human Interface Device (HID) class devices. This feature requires the USB component to be installed on both sender and receiver. The USB icon on the toolbar is disabled for collaborators.

The USB Selection window lists all USB devices connected to the receiver. Some options may be greyed out based on disabled USB classes in the configuration file.

  • Connect: Select a desired USB device and click Connect. A plug icon and green background indicate a successful connection. The device is then unavailable on the receiver.
  • Disconnect: Select a connected device and click Disconnect.
  • Warning: Connecting a local keyboard or pointing device (mouse, tablet, touch screen) to the remote host will trigger a warning, as it may make local computer control difficult.

Collaboration:

The first user to log into a TGX sender is the desktop owner. Other users connected to the sender are collaborators. The desktop owner has administrative privileges, including the ability to disconnect collaborators and manage their keyboard/mouse input. TGX supports up to 4 concurrent collaborators (default is 4, but can be increased or disabled by IT).

Connection Requests:

Collaborator connection requests trigger a pop-up on the sender, requiring the desktop owner to authenticate the collaborator.

  • Allow: Permits the collaborator to connect.
  • Deny: Prevents the connection.
  • Enable input for this collaborator: Automatically enables input for the collaborator. If not selected, input is disabled by default. If no response within 15 seconds, the connection is denied.

Collaborators List:

The TGX icon in the system tray shows a list of collaborators. The desktop owner can click the mouse icon to deny collaborator keyboard/mouse control or click the X to disconnect them. Hovering over a collaborator's name shows the computer name.

Auto-Reconnect:

If the network connection between receiver and sender is lost, TGX attempts to reconnect automatically. The receiver video may freeze for up to 30 seconds before the receiver detects the disruption. A semi-transparent gray overlay indicates auto-reconnect mode. If the network is reestablished, video and audio from the sender desktop will automatically become live. User input is required by the user as part of the reconnect. During auto-reconnect, the user may disconnect from the sender by selecting the "X" on the Receiver per standard TGX disconnect process or choose to change window modes. Auto-reconnect is intended for recovery from short duration network interruptions (e.g., VPN restart, network adapter switch). If the VPN goes down, the user must restart the VPN connection manually. If TGX connection goes through a port forwarding gateway, auto-reconnect is only valid for the length of time that the port remains open per the policy of the network administrator.

Remote Clipboard:

TGX supports copy/paste of plain text, formatted text, Excel tables, and images. The desktop owner has access to the clipboard of both sender and receiver. Collaborators have one-way copy/paste functionality from receiver to sender.

Audio:

Audio output from the sender is shared with the receiver(s). A volume control slider is available on the TGX toolbar. If TGX window is minimized, audio is paused until the TGX window is restored. TGX sends audio associated with the sender's default speaker.

Keyboard and Mouse:

The receiver's mouse cursor is over the TGX window, the cursor icon of the sender's mouse will be displayed. The mouse cursor of a collaborator that does not have mouse/keyboard control will be indicated by an X. On Windows, system key combinations like ALT + TAB, Windows key combinations, and menu key combinations are transferred. CTRL+ALT+DELETE, Windows + L, and multi-media keys are not transferred. TGX attempts to match the sender's locale/language to the receiver's. The sender's keyboard layout is automatically set to the default layout identified for that locale/language. This works on Windows-based sender connected to Windows or Mac receiver. This behavior can be disabled via configuration entries.

Acknowledgements:

TGX uses several third-party technologies, including:

  • argtable3: argtable3 library (license: argtable3-LICENSE.txt).
  • boost 1.70: boost library (license: Boost Software License, Version 1.0; boost-LICENSE_1_0.txt).
  • dialog: dialog tool (license: LGPL version 2.1; lgpl-2.1-LICENSE.txt).
  • FlatBuffers: Developed by Wouter van Oortmerssen and Google (license: Apache License 2.0; Apache-LICENSE-2.0.txt).
  • FreeType: FreeType library (license: FTL license; freetype-LICENSE.txt).
  • Intel: Media SDK and Performance Primitives from Intel. TGX license prohibits disassembly and reverse engineering of Redistributables.
  • FFmpeg: FFmpeg library (license: LGPL version 2.1; lgpl-2.1-LICENSE.txt).
  • libpng: libpng library version 1.6.34 (license: libpng-LICENSE.txt).
  • log4cpp: log4cpp library (license: LGPL version 2.1; lgpl-2.1-LICENSE.txt).
  • nowide: nowide library (license: Boost Software License, Version 1.0; boost-LICENSE_1_0.txt).
  • Makeself: Makeself tool for Linux installer (license: GPL version 2.0).
  • NVIDIA: NVIDIA provided software libraries. Mechdyne is a Preferred Solution Provider for Professional Visualization and GPU Virtualization.
  • OpenSSL: Software developed by the OpenSSL Project (http://www.openssl.org/) and cryptographic software by Tim Hudson and Eric Young (license: openssl-LICENSE.txt).
  • Qt 5.15: Qt Version 5 (license: LGPL Version 3; lgpl-3.0-LICENSE.txt). Third-party product licenses are in ThirdPartyLicensesCarriedWithQT.pdf.
  • RCF 3: RCF 3 library by Delta V Software (commercial license).
  • Scalable Graphics: Technology by Scalable Graphics (specific licensing agreement).
  • zlib: zlib library version 1.2.11 (license: libzlib-LICENSE.txt).
  • 7-Zip: 7-Zip version 16.0 (license: LGPL version 2.1; lgpl-2.1-LICENSE.txt).

Copies of all licenses are provided in the Documentation directory under ThirdPartyLicenses.

Mechdyne Corporation TGX Specifications

General IconGeneral
BrandMechdyne Corporation
ModelTGX
CategoryDesktop
LanguageEnglish