Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thibauts/node-upnp-mediarenderer-client
An UPnP/DLNA MediaRenderer client
https://github.com/thibauts/node-upnp-mediarenderer-client
Last synced: 6 days ago
JSON representation
An UPnP/DLNA MediaRenderer client
- Host: GitHub
- URL: https://github.com/thibauts/node-upnp-mediarenderer-client
- Owner: thibauts
- License: mit
- Created: 2014-10-21T01:49:13.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2022-01-04T02:08:27.000Z (about 3 years ago)
- Last Synced: 2024-12-30T14:17:40.386Z (13 days ago)
- Language: JavaScript
- Size: 17.6 KB
- Stars: 128
- Watchers: 7
- Forks: 30
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
upnp-mediarenderer-client
=========================
### An UPnP/DLNA MediaRenderer client
This module allows you to control an UPnP/DLNA MediaRenderer directly (usually your TV set). It implements load, play, pause, stop and seek commands.
Events coming from the MediaRenderer (ie. fired from the TV remote) such as `playing`, `paused`, `stopped` can be listened to.
External subtitles are supported through DIDL-Lite metadata, but be aware that some MediaRenderers require the HTTP server serving the media file to return specific headers as illustrated in this [gist](https://gist.github.com/thibauts/5f5f8d8ce6566c8289e6). Also, some MediaRenderers don't support external subtitles at all.
Installation
------------
```bash
$ npm install upnp-mediarenderer-client
```
Usage
-----
```javascript
var MediaRendererClient = require('upnp-mediarenderer-client');
// Instanciate a client with a device description URL (discovered by SSDP)
var client = new MediaRendererClient('http://192.168.1.50:4873/foo.xml');
// Load a stream with subtitles and play it immediately
var options = {
autoplay: true,
contentType: 'video/avi',
metadata: {
title: 'Some Movie Title',
creator: 'John Doe',
type: 'video', // can be 'video', 'audio' or 'image'
subtitlesUrl: 'http://url.to.some/subtitles.srt'
}
};
client.load('http://url.to.some/stream.avi', options, function(err, result) {
if(err) throw err;
console.log('playing ...');
});
// Pause the current playing stream
client.pause();
// Unpause
client.play();
// Stop
client.stop();
// Seek to 10 minutes
client.seek(10 * 60);
// Get the volume
client.getVolume(function(err, volume) {
if(err) throw err;
console.log(volume); // the volume range is 0-100
});
// Set the volume
client.setVolume(40, function(err) {
if(err) throw err;
console.log("volume is now", volume);
});
client.on('status', function(status) {
// Reports the full state of the AVTransport service the first time it fires,
// then reports diffs. Can be used to maintain a reliable copy of the
// service internal state.
console.log(status);
});
client.on('loading', function() {
console.log('loading');
});
client.on('playing', function() {
console.log('playing');
client.getPosition(function(err, position) {
console.log(position); // Current position in seconds
});
client.getDuration(function(err, duration) {
console.log(duration); // Media duration in seconds
});
});
client.on('paused', function() {
console.log('paused');
});
client.on('stopped', function() {
console.log('stopped');
});
client.on('speedChanged', function(speed) {
// Fired when the user rewinds of fast-forwards the media from the remote
console.log('speedChanged', speed);
});
```