Skip to content
Permalink
Browse files
GUACAMOLE-724: Merge connection tiling and keyboard focus documentation.
  • Loading branch information
jmuehlner committed Dec 29, 2021
2 parents 52e439f + e859f27 commit b88a223c67fad90fd0a920a2342a051c13c730c9
Showing 7 changed files with 73 additions and 8 deletions.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@@ -82,20 +82,24 @@ again or swipe left across the screen.

The Guacamole menu provides options for:

* Navigating back to the home screen
* [Reading from (and writing to) the clipboard of the remote
desktop](using-the-clipboard)

* Sharing the current connection
* [Switching between active connections and displaying multiple connections at
once](client-connection-menu)

* Reading from (and writing to) the clipboard of the remote desktop
* [Navigating back to the home screen](client-user-menu)

* Uploading and downloading files
* [Disconnecting from the current connection entirely](client-user-menu)

* Selecting alternative methods of typing or controlling the mouse,
particularly for use on mobile or touchscreen devices
* [Sharing the current connection](client-share-menu)

* Zooming in and out of the remote display
* [Uploading and downloading files](file-transfer)

* Disconnecting from the current connection entirely
* [Zooming in and out of the remote display](scaling-display)

* [Selecting alternative methods of typing or controlling the mouse,
particularly for use on mobile or touchscreen devices](touch-devices)

(using-the-clipboard)=

@@ -115,6 +119,67 @@ Similarly, if you copy or cut text within the remote desktop, you will see that
text within the text area, and can manually copy it into the local clipboard if
desired.

(client-connection-menu)=

Switching and tiling connections
--------------------------------

If you have access to more than one connection, clicking the current connection
name at the top of the Guacamole menu will open a drop-down menu containing a
list of your other available connections:

![Connection menu with one connection selected](images/client-connection-menu.png)

Clicking on the name of another connection in this drop-down menu will
immediately switch to that connection. The previous connection will remain
running as a thumbnail within a panel attached to the lower-right corner of the
screen. This panel updates in real-time and remains visible as long as you have
multiple active connections, even if you navigate away to another part of the
Guacamole application:

![Active connection panel](images/client-panel.png)

Clicking on any connection within the panel will navigate back to that
connection, while clicking the "X" icon in the upper-right corner of the
connection thumbnail will immediately close the connection.

(client-tiling)=

### Adding a connection to the current view

Multiple connections may also be opened simultaneously within the same view by
clicking the checkboxes next to the names of those connections in the
connection menu:

![Connection menu with two connections selected](images/client-connection-menu-multiple.png)

All connections opened in this way are automatically arranged in equally-sized
tiles to fill the available area:

![Multiple client displays in a tiled arrangement](images/client-tiled.png)

With multiple connections displayed as tiles, keyboard interaction and the
Guacamole menu will only affect the currently focused connection, as indicated
by the blue title and border. Clicking or tapping within another connection
will change the focus and allow keyboard interaction with _that_ connection.

(client-broadcast-keyboard)=

### Typing with multiple connections

By holding down {kbd}`Ctrl` (to select an individual connection) or
{kbd}`Shift` (to select a rectangle of connections), multiple connection may be
focused at the same time. While multiple connections are focused, each key
pressed will be broadcast across each focused connection:

![Multiple focused client displays in a tiled arrangement](images/client-tiled-multi-focus.png)

This is particularly useful for running the same series of commands on multiple
computers. Further, since Guacamole automatically translates between the user's
local keyboard layout and the keyboard layout of the remote server, _this will
work as expected even if the keyboard layouts of focused connections do not
match_.

(client-user-menu)=

Disconnecting and navigation

0 comments on commit b88a223

Please sign in to comment.