Features transition from version 1.0.x

If you already have an application version below 1.1.0 and there are address books that are of value to you:

  1. You need to transfer all address books to the “No encryption” mode before installation.
  2. Uninstall the old version of Aspia.
  3. Install the new version of “Aspia Console”.

After installing the new version of Aspia, you can enable address book encryption.

Host (server side)

The installation program “Aspia Host” comes in the form of a package for Windows Installer (* .msi). The installation language is determined automatically based on the current Windows language settings.

It is possible to automate the installation and initial setup.

To do this, you must do the following:

  1. Install the Aspia Host application on one of the computers
  2. Configure settings and add users
  3. Export configuration to file aspia-host-config.xml
  4. Place the aspia-host-config.xml file in the same directory as the installer

When installed on other computers, the parameters from the file will be automatically imported.

To manage the settings, you need to run the Aspia Host Configurator. The configurator contains several tabs that allow you to configure all supported parameters.

“General” tab:

Allows you to control the following parameters:

  1. Application language
  2. Service management (install and uninstall, start and stop)
  3. Settings for incoming connections
  4. Import and export configuration

Import and export settings allow you to save the current configuration to an XML file for later recovery (for backup purposes) or automatic deployment.

Import and export of parameters can be done through a graphical user interface and from the command line.

To perform import and export via a graphical interface, the “Export” and “Import” buttons in the “Aspia Host Configurator” tab in the “General” tab.

To perform import and export via the command line, use the following commands:

aspia_host_config --import <file>
aspia_host_config --export <file>

For more detailed information on command line parameters, run the command:

aspia_host_config --help

To manage users, you need to run the Aspia Host Configurator and go to the “Users” tab.

To add a user, click on the button with the icon . To delete a user, use the button , and to edit button .

The dialog for adding or changing a user is as follows:

When adding a new user, you need to enter a username and password, as well as select the types of sessions that this user can connect to.

It is possible to check for updates and perform the update directly from the user interface. To do this, run the Aspia Host Configurator and go to the Update tab.

To check for updates, you must click the “Check for updates”. A dialog to check for updates will appear.

If an update is available for your version of the application, the update version, a link for manual download and a description of the update, and the button “Update now!” will become active. When you click on the update button, it will be downloaded and automatically installed.

You can also specify your own server to check for updates, if for some reason you are not satisfied with the default server.

Console (client side)

Address book is used to perform a quick connection to computers. You can add computer groups, computers, manage connection settings to computers.

Address book can be encrypted and not encrypted. When you open an encrypted address book, you must enter a password to access it.

Address books open in the Aspia Console and are tabs. You can create multiple address books and open them simultaneously.

To simplify the opening of address books, a list of recent open address books is maintained:

You can also use the option to “pin” tabs with address books. To do this, click on the tab title with the right mouse button and select “Pin tab”. Pinned tabs will automatically open when the application starts.

To organize computers is convenient to use groups. You can create an unlimited number of groups of varying degrees of nesting. To add, change and delete computer groups, use the corresponding items on the toolbar or in the context menus.

Fields in the dialogue

Name Description
NameThe name of the computer group. The field is required.
CommentFreely editable field for making notes. Not required.

To add a computer, select the group to which you want to add it and click “Add Computer”. To change a computer, right-click on it and select “Change Computer”. The computer properties dialog opens.

Name Description
NameThe name of the computer. It is required.
AddressAddress of the remote computer. It is required.
User nameUsername for connecting to a remote computer. Not required. If the field is empty, then a login dialog will be displayed upon connection.
PasswordPassword to connect to a remote computer. Not required. If the field is empty, then a login dialog will be displayed upon connection.
CommentFreely editable field for making notes. Not required.

If you need to specify a port for connection, then this can be done by specifying it through the “:” symbol after the address.

Address entry examples

IPv4 address and port:

192.168.1.10:8000

IPv6 address and port:

[2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d]:8080

Computer or domain name:

home-pc:8080
Key combination Description
Ctrl+NCreating a new address book
Ctrl+OOpening the address book file
Ctrl+SSaving an address book file
Ctrl+Alt+SSave address book as …
Ctrl+Shift+SSave all address books
Ctrl+WClose address book
Ctrl+Shift+WClose all address books
Alt+F4Exit application
F1Call online help
InsertAdding a group of computers or a computer (depending on the current input focus)
F2Change group of computers or computer (depending on the current input focus)
DeleteDelete a computer group or computer (depending on the current input focus)
EnterConnect to computer

Control buttons and their meaning

When you connect to desktop management, a toolbar appears at the top of the window.

Name Description
Lock toolbarIf the button is clamped, the toolbar will always be displayed. Otherwise, after a few seconds after moving the mouse pointer outside the panel, it will be hidden.
SetttingsInvokes the dialog to change session parameters.
Select monitorAllows you to switch between displaying individual monitors or the entire desktop. Only displayed if there is more than one monitor on the host side.
Power managementAllows you to shut down or restart the computer, end or block a user session.
Отправить Ctrl+Alt+DelОтправляет соответствующую комбинацию клавиш на удаленный компьютер.
Automatic window sizeChanges the window size to the optimal one based on the size of the monitors of the remote and local computers.
Full screenSwitches the control window to full screen or returns the original state.
File transferStarts file transfer
System informationDisplays a window with information about the remote computer.
Remote updateRuns an application update on a remote computer. Displayed only when the host version is smaller than the console.
Extended menuDisplays an advanced menu of advanced features.

Extended menu

Name Description
Scaling an imageWhen you enable this feature, the image of the remote desktop will fit in proportion to the window size.
Automatic scrollingWhen this function is enabled, the desktop image will automatically scroll when the cursor approaches the window borders.
Send key combinationsWhen you turn on this feature, system key combinations will be automatically intercepted and transmitted (for example, “Print Screen”, “Win”, “Alt + Tab”).
Save screenshotSave a snapshot of the remote screen to a file.

Session settings

"Codec" tab
Parameter Description
CodecYou can choose which codec to use. There are 3 options available: ZLIB (default), VP8 and VP9. ZLIB is well suited for slow connections, allows you to specify the color depth and level of compression. VP8 and VP9 are video codecs and are well suited for fast connections.
Color depthSets the color depth. The smaller the color depth, the less data will be transmitted over the network. This parameter is available only for ZSTD codec.
Compression levelSets the level of compression. The higher the compression level, the less data will be transmitted over the network. Setting higher levels of compression may result in lower coding rates. This parameter is available only for ZSTD codec.
"Remote screen" tab
Parameter Description
Scale factorThe scale of the remote screen (the image is resized on the host side, the amount of data transmitted over the network will be reduced proportionally to the decrease in scale).
Update intervalSpecifies the time interval at which the host will seek to update the desktop image.
"Advanced" tab
Parameter Description
Block remote inputThe user of the remote computer will not be able to perform input through the mouse and keyboard. However, the Ctrl+Alt+Del key combination remains available.
Enable cursor shapeWhen enabled, the local cursor takes the form of a remote one.
Enable clipboardWhen this option is enabled, the automatic exchange of the clipboard between the local and remote computers will occur.
Disable desktop effectsWhen enabled, desktop effects (such as animation, smooth scrolling) will be disabled for the duration of the connection.
Disable desktop wallpaperWhen enabled, the desktop wallpaper will be disabled for the duration of the connection.

System information

Allows you to view basic information about the remote computer. The resulting information can be saved to an HTML file or printed out on a printer.

Double-clicking on any line with information about the system will be copied to the clipboard. In the context menu, you can selectively copy the name of the parameter, its value or a string in its entirety.

Supported hot keys

Key combination Description
Ctrl+SSave information to file
Ctrl+PPrint information on the printer
Ctrl+CCopy current line of information
F5Update information

Allows you to transfer a file between local and remote computers, delete, rename files, create directories. When connected to a remote computer lists of disks are displayed that allow you to estimate the amount of free space on them.

Hotkeys

Key combination Description
BackspaceGo to parent directory
F2Rename selected item
F4View list of disks
F5Refresh
F11Send selected item or items
DeleteDelete selected item or items

The Aspia Console supports command line operation. You can connect to a computer or open the address book file by executing the appropriate commands.

To connect to a computer, run the command:

aspia_console --address <address> --port <port> --username <user_name> --session-type <session_type>

   - address - Address of the host to which you connect
   - port - TCP port of the host to connect to
   - user_name - User name
   - session_type - Session type. May take values
                  "desktop-manage"
                  "desktop-view"
                  "file-transfer"

To call the quick connect dialog:

aspia_console --simple-ui

To open your address book:

aspia_console <file>

For more detailed information on command line parameters, run the command:

aspia_host_config --help

It is possible to check for updates and perform the update directly from the user interface. To do this, launch the Aspia Console and select the “Check for updates” item in the “Help” menu.

A dialog to check for updates will appear.

If an update is available for your version of the application, the update version, a link for manual download and a description of the update, and the “Update now!” button will be displayed. will become active. When you click on the update button, it will be downloaded and automatically installed.

  • Last modified: 2019/02/11 18:16