# kurento-client-sw > JavaScript Client API for Kurento Media Server Latest version **6.15.1-dev** (published 2021-02-26) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install kurento-client-sw pnpm add kurento-client-sw yarn add kurento-client-sw bun add kurento-client-sw ``` ## Health **Score 5/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: insecure dependencies; abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 6.15.1-dev | | Published | 2021-02-26 | | First published | 2021-02-26 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 12 | | Unpacked size | 80.8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 106 | | Author | Kurento | | Maintainers | swliu | | Keywords | kurento, mcu, sfu, rpc, mediaserver, pipe, audio, video, media, recording, stream, streaming, videoconference, broadcast, multicast, client, server, browser, chrome, edge, firefox, safari, webrtc, datachannel, sdp, ice, stun, turn, h264, h.264, opus, vp8, rtp, srtp, rtsp | ## Links - npm: https://www.npmjs.com/package/kurento-client-sw - Repository: https://github.com/Kurento/kurento-client-js - Homepage: https://www.kurento.org - Issues: https://github.com/Kurento/bugtracker/issues - npm.io page: https://npm.io/package/kurento-client-sw ## Dependencies (12) - [async](https://npm.io/package/async.md) ^2.0.1 - [extend](https://npm.io/package/extend.md) ^3.0.0 - [promise](https://npm.io/package/promise.md) 7.1.1 - [inherits](https://npm.io/package/inherits.md) ^2.0.0 - [minimist](https://npm.io/package/minimist.md) ^1.2.0 - [es6-promise](https://npm.io/package/es6-promise.md) ^4.0.5 - [reconnect-ws](https://npm.io/package/reconnect-ws.md) github:KurentoForks/reconnect-ws#master - [kurento-jsonrpc](https://npm.io/package/kurento-jsonrpc.md) git+https://github.com/Kurento/kurento-jsonrpc-js.git - [promisecallback](https://npm.io/package/promisecallback.md) 0.0.4 - [kurento-client-core](https://npm.io/package/kurento-client-core.md) git+https://github.com/Kurento/kurento-client-core-js.git - [kurento-client-filters](https://npm.io/package/kurento-client-filters.md) git+https://github.com/Kurento/kurento-client-filters-js.git - [kurento-client-elements](https://npm.io/package/kurento-client-elements.md) git+https://github.com/Kurento/kurento-client-elements-js.git ## Alternatives - [byte-size](https://npm.io/package/byte-size.md) — 2.1M weekly downloads - [speed-limiter](https://npm.io/package/speed-limiter.md) — 16.0K weekly downloads - [@powersync/node](https://npm.io/package/@powersync/node.md) — 10.9K weekly downloads - [@ledgerhq/coin-cardano](https://npm.io/package/@ledgerhq/coin-cardano.md) — 1.0K weekly downloads - [@jayesol/jayeson.lib.streamfinder](https://npm.io/package/@jayesol/jayeson.lib.streamfinder.md) — 1.0K weekly downloads ## Recent versions - 6.15.1-dev (latest) — 2021-02-26 ## README [![License badge](https://img.shields.io/badge/license-Apache2-orange.svg)](http://www.apache.org/licenses/LICENSE-2.0) [![Documentation badge](https://readthedocs.org/projects/fiware-orion/badge/?version=latest)](http://doc-kurento.readthedocs.org/en/latest/) [![Docker badge](https://img.shields.io/docker/pulls/fiware/orion.svg)](https://hub.docker.com/r/fiware/stream-oriented-kurento/) [![Support badge]( https://img.shields.io/badge/support-sof-yellowgreen.svg)](http://stackoverflow.com/questions/tagged/kurento) [![][KurentoImage]][Kurento] Copyright © 2013-2016 [Kurento]. Licensed under [Apache 2.0 License]. JavaScript Kurento Client ========================= The project contains the implementation of the JavaScript Kurento Client for web applications and Node.js. The source code of this project can be cloned from the [GitHub repository]. supports async-await out of the box Installation instructions ------------------------- These instructions are intended for code contributors or people willing to compile the browser version themselves. If you are a browser-only developer, it's better that you have a look at the [JavaScript Kurento Client for Bower] instructions. ### Node.js Be sure to have installed [Node.js] in your system: ```bash curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt-get install -y nodejs ``` To install the library, it's recommended to do that from the [NPM repository] : ```bash npm install kurento-client ``` Alternatively, or if you want to modify the JavaScript Kurento Client code or generate yourself the browser version of the library, you can download the development code files using git and install manually its dependencies: ```bash git clone https://github.com/Kurento/kurento-client-js cd kurento-client-js npm install ``` In this last case, you will also need to have installed [Kurento Module Creator] so you can be able to generate the client libraries code. ### Browser To build the browser version of the library, after downloading the development code files, you'll only need to exec the [grunt] task runner from the root of the project and they will be generated on the ```dist``` folder. Alternatively, if you don't have it globally installed, you can run a local copy by executing ```bash node_modules/.bin/grunt ``` How to test ----------- Tests are autonomous and based on [QUnit] testing framework. Their only requirement is to exec previously ```npm install``` to have installed all the dev dependencies. ### Browser After building the web browser version of the library, just open the file ```test/index.html``` with any browser, and the tests will launch automatically. In case of the browser raise some security policy errors, you can host the tests code by running any static web server at the source code root folder, for example by launching the command ```bash python -m SimpleHTTPServer 8000 ``` You can be able to configure to what WebSocket endpoint you want to connect on the dropdown list at the top of the tests page. ### Node.js To exec test in Node.js, you only need to exec ```npm test```, that will launch all the tests automatically using [QUnit-cli]. Note that a Kurento Media Server instance must be also up, in order to have all tests run against it. At this moment, the default WebSocket endpoint can not be changed due to limits of the current implementation of NPM. If you need to use a different WebSocket endpoint from the default one, you can exec the underlying test command and append a *ws_uri* parameter pointing to the alternative WebSocket endpoint: ```bash node_modules/.bin/qunit-cli -c kurentoClient:. -c wock:node_modules/wock -c test/_common.js -c test/_proxy.js test/*.js --ws_uri=ws://localhost:8080 ``` Kurento ======= What is Kurento --------------- Kurento is an open source software project providing a platform suitable for creating modular applications with advanced real-time communication capabilities. For knowing more about Kurento, please visit the Kurento project website: http://www.kurento.org. Kurento is part of [FIWARE]. For further information on the relationship of FIWARE and Kurento check the [Kurento FIWARE Catalog Entry] Kurento is part of the [NUBOMEDIA] research initiative. Documentation ------------- The Kurento project provides detailed [documentation] including tutorials, installation and development guides. A simplified version of the documentation can be found on [readthedocs.org]. The [Open API specification] a.k.a. Kurento Protocol is also available on [apiary.io]. Source ------ Code for other Kurento projects can be found in the [GitHub Kurento Group]. News and Website ---------------- Check the [Kurento blog] Follow us on Twitter @[kurentoms]. Issue tracker ------------- Issues and bug reports should be posted to the [GitHub Kurento bugtracker] Licensing and distribution -------------------------- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Contribution policy ------------------- You can contribute to the Kurento community through bug-reports, bug-fixes, new code or new documentation. For contributing to the Kurento community, drop a post to the [Kurento Public Mailing List] providing full information about your contribution and its value. In your contributions, you must comply with the following guidelines * You must specify the specific contents of your contribution either through a detailed bug description, through a pull-request or through a patch. * You must specify the licensing restrictions of the code you contribute. * For newly created code to be incorporated in the Kurento code-base, you must accept Kurento to own the code copyright, so that its open source nature is guaranteed. * You must justify appropriately the need and value of your contribution. The Kurento project has no obligations in relation to accepting contributions from third parties. * The Kurento project leaders have the right of asking for further explanations, tests or validations of any code contributed to the community before it being incorporated into the Kurento code-base. You must be ready to addressing all these kind of concerns before having your code approved. Support ------- The Kurento project provides community support through the [Kurento Public Mailing List] and through [StackOverflow] using the tags *kurento* and *fiware-kurento*. Before asking for support, please read first the [Kurento Netiquette Guidelines] [documentation]: http://www.kurento.org/documentation [FIWARE]: http://www.fiware.org [GitHub Kurento bugtracker]: https://github.com/Kurento/bugtracker/issues [GitHub Kurento Group]: https://github.com/kurento [kurentoms]: http://twitter.com/kurentoms [Kurento]: http://kurento.org [Kurento Blog]: http://www.kurento.org/blog [Kurento FIWARE Catalog Entry]: http://catalogue.fiware.org/enablers/stream-oriented-kurento [Kurento Netiquette Guidelines]: http://www.kurento.org/blog/kurento-netiquette-guidelines [Kurento Public Mailing list]: https://groups.google.com/forum/#!forum/kurento [KurentoImage]: https://secure.gravatar.com/avatar/21a2a12c56b2a91c8918d5779f1778bf?s=120 [Apache 2.0 License]: http://www.apache.org/licenses/LICENSE-2.0 [NUBOMEDIA]: http://www.nubomedia.eu [StackOverflow]: http://stackoverflow.com/search?q=kurento [Read-the-docs]: http://read-the-docs.readthedocs.org/ [readthedocs.org]: http://kurento.readthedocs.org/ [Open API specification]: http://kurento.github.io/doc-kurento/ [apiary.io]: http://docs.streamoriented.apiary.io/ [GitHub repository]: https://github.com/kurento/kurento-client-js [grunt]: http://gruntjs.com/ [Kurento Module Creator]: https://github.com/Kurento/kurento-module-creator [KurentoImage]: https://secure.gravatar.com/avatar/21a2a12c56b2a91c8918d5779f1778bf?s=120 [JavaScript Kurento Client for Bower]: https://github.com/Kurento/kurento-client-bower [Node.js]: http://nodejs.org/ [NPM repository]: https://www.npmjs.org/package/kurento-client [QUnit]: http://qunitjs.com [QUnit-cli]: https://github.com/devongovett/qunit-cli --- _Source: https://npm.io/package/kurento-client-sw · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._