npm.io
1.5.1 • Published 5 years ago

@kriive/ngx-remote-desktop

Licence
MIT
Version
1.5.1
Deps
16
Size
887 kB
Vulns
19
Weekly
0
Install scriptsThis package runs scripts during installation (preinstall/install/postinstall)

ngx-remote-desktop

npm version

For installation and usage details go here

ngx-remote-desktop is an Angular component for connecting to a remote desktop using the guacamole remote desktop gateway

This is a fork of ILLGrenoble's initial work with little tweaks to make it work on Angular 11. It is based on the angular-8 branch of the upstream repo. The work on this repo is highly experimental, as I have no prior experience on publishing packages to npm. Take this repo with a grain of salt.

It has been built for use with Angular 5.0.0+ (tested also with Angular 11). It has been tested in Chrome, Firefox, Edge and Safari. It makes heavy use of flex, therefore it will not work in browsers that do not support flex.

There is no dependency on any presentation component library / framework (ng-bootstrap, clarity etc.). This component does not make any assertions about how the backend web socket broker to guacd is implemented.

By default, there are no toolbar items, however, you can add as many toolbar items as you wish and create a handler in your component. You can also override the scss if you wish to change the styling. The RemoteDesktopManager exposes some useful methods for generating a screenshot or thumbnail, entering and exiting full screen mode, focusing and unfocusing the display, getting the client state, subscribing to the remote desktop clipboard and sending data to the remote desktop clipboard.

Screenshot

Features

  • Fluid screen resizing and scaling
  • Full screen mode
  • Toolbar (auto hide when in full screen mode)
  • Take a screenshot
  • Get a thumbnail
  • Subscribe to the remote clipboard observable and receive remote clipboard data
  • Send data to the remote clipboard
  • Status bar (optional) to provide contextual information

For a full implementation example, see the demo source code

Installation

To use ngx-remote-desktop in your project, install it via npm:

npm i @kriive/ngx-remote-desktop --save

We also require two peer dependencies:

npm i @illgrenoble/guacamole-common-js --save
npm i screenfull --save
Thank you

Thank you to the guacamole team for a fantastic project.