Share via Share via... Twitter LinkedIn Facebook Pinterest Telegram WhatsApp Yammer Reddit TeamsRecent ChangesPrint × Table of Contents Features transition from version 1.0.x Host (server side) Installation General settings Import and export settings User management Update Console (client side) Address book Computer group management Computer management Hotkeys Session types Manage and view desktop File transfer Command line Update Features transition from version 1.0.x Warning! Versions 1.1.0 and above are not compatible with previous versions of the application. You will not be able to connect to computers with the old version of the application. Address book compatibility is preserved, but you must follow the steps below. Warning! Starting from version 1.1.0, the client part (console) and server (host) are separate and have individual installers. If you already have an application version below 1.1.0 and there are address books that are of value to you: You need to transfer all address books to the “No encryption” mode before installation. Uninstall the old version of Aspia. Install the new version of “Aspia Console”. After installing the new version of Aspia, you can enable address book encryption. Host (server side) Installation 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: Install the Aspia Host application on one of the computers Configure settings and add users Export configuration to file aspia-host-config.xml 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. General settings 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: Application language Service management (install and uninstall, start and stop) Settings for incoming connections Import and export configuration Import and export settings 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 User management 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. Warning! When you change your username, you also need to re-enter the password. Update 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. Warning! When performing an automatic update, the application will be closed. All unsaved data will be lost. All connected sessions will be completed. After the upgrade is complete, you will be able to connect again. Console (client side) Address book 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. Warning! When storing passwords in your address book without encryption or with a very simple password, you need to understand that this is a potential security risk and third parties can access the management of computers from the address book. 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. Computer group management 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. Computer management 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 Hotkeys 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 Session types Manage and view desktop 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 File transfer 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 Command line 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" Warning! Passing a password through command line parameters is a security risk and is not available. 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 Update 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. Warning! When performing an automatic update, the application will be closed. All unsaved data will be lost. All connected sessions will be completed. After the upgrade is complete, you will be able to connect again. Last modified: 2019/02/11 18:16 Log In