Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
mdns/zeroconf/bonjour service discovery add-on for node.js
branch: master

This branch is 180 commits behind agnat:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
examples
lib
src
tests
utils
.gitignore
.npmignore
CHANGES
LICENSE
Makefile
README.textile
binding.gyp
node-waf.bat
package.json
wscript

README.textile

mdns — node.js Service Discovery

Package: mdns
Description: multicast DNS service discovery
Version: 0.0.7
Installation: npm install mdns
Documentation: mdns user guide
License: MIT

mdns adds multicast DNS service discovery, also known as zeroconf or bonjour to node.js. It provides an object based interface to announce and browse services on the local network.

Synopsis

// import the module
var mdns = require('mdns');

// advertise a http server on port 4321
var ad = mdns.createAdvertisement(mdns.tcp('http'), 4321);
ad.start();

// watch all http servers
var browser = mdns.createBrowser(mdns.tcp('http'));
browser.on('serviceUp', function(service) {
  console.log("service up: ", service);
});
browser.on('serviceDown', function(service) {
  console.log("service down: ", service);
});
browser.start();

// discover all available service types
var all_the_types = mdns.browseThemAll(); // all_the_types is just another browser...

Installation

mdns is available as a npm package:

npm install mdns

On Linux and other systems using the avahi daemon the avahi dns_sd compat library and its header files are required. On debianesque systems the package name is libavahi-compat-libdnssd-dev. On other platforms Apples mDNSResponder is recommended. Care should be taken not to install more than one mDNS stack on a system.

If you want to play with the latest source code, here is a more manual approach:

git clone http://github.com/agnat/node_mdns
cd node_mdns
npm link && npm test

Documentation

See the user guide.

Contributors

… in random order:

Your name is missing on the list? Shame on me. Please open an issue.

Bugs and Contributions

If you find a bug, please report it using the issue tracker.

Something went wrong with that request. Please try again.