Repository files navigation

💚 A persistent solution to presenting content across multiple Chromecast devices, inspired byGreenscreen.

Developed with Node, Express, and Mongo.

From the home page, you can manage displays via Chromecasts, manage all available content via Channels, create and trigger alerts via Push Alerts, or takeover all display by starting a Takeover.

All content is managed via Channels, which are unique URLs that can be assigned to each individual device. There is no limit on the number of Channels you can have available at any one time, and you can freely switch between them on a per-device basis.

To access Channels, select Channels from the homepage, or click Channels in the top right of the interface.

A channel consists of a Name and Layout. The channel's name will be used to refer to it throughout the interface, but will never be displayed on the actual device when it is being cast. The channel's layout allows one or more URLs to be embedded (via iframe) into the page that will be cast. Two layouts are provided, though creating additional layouts is not especially difficult (seeCreating Layouts).

Chromecast devices are now interfaced with as mDNS devices via the newCastv2 API. This removes the Chrome/Chromium browser restriction that previously existed with Chromecast devices, and even allows Multicast to be run remotely from a headless server (seeSetup).

All Chromecast devices on the same network as the host will display here. Devices can beregistered to be activated as Multicast receivers and assigned a channel, receive push alerts, and so on.

To register a device, click on the device's name or click Register Chromecast.

A device's name will be whatever the Chromecast's name was when it was set up. A device's Location can be set to anything you would like to clarify where it is located. Make sure to choose something descriptive, as this will make Channel management easier down the line.

You can choose not to select a Channel when registering a device - doing so will leave the device on the default registration screen until a Channel is selected.

Once a device has been registered, you can select its name from the Devices list to change the Channel it is displaying, refresh its Channel content, or Reconnect it if loses connection.

Push Alerts are useful for displaying small pieces of information to all receiver devices. Alerts will begin displaying on all connected receivers as soon as they are created, and will continue to display until their set duration is reached or the receiver is reset.

A Channel Takeover allows all receiver devices to be temporarily, indefinitely redirected to a single channel. A Takeover will begin immediately after it is started, and will last until it is manually stopped from the homepage.

*Takeovers will also affect devices that are registered after they have begun.

This project requires Node.js and NPM (bundled with Node), as well as a MongoDB server. Since Node is cross-platform, it should work on Windows, MacOS, and Linux.

This project depends onnode_mdns, which in turn requires a mDNS stack. Follow the installation instructionshere for whichever platform you are on to install a mDNS stack. If you're on Linux, this is as simple as

sudo apt-get install build-essential libavahi-compat-libdnssd-dev

sudo yum install gcc gcc-c++ avahi avahi-compat-libdns_sd avahi-compat-libdns_sd-devel nss_mdns

If you don't already have access to a MongoDB server installation, follow the guidehere.

Grab the latest stable copy of Node/NPM fromhere or install it vianvm.

In order to access the Chromecast API, you need toregister as a Cast developer (it costs $5).

Once you've done this, log in to theCast Developer SDK Console and clickAdd New Application. ChooseCustom Receiver, then name itMulticast and set theReceiver Application URL tohttp://YOUR_LOCAL_IP:3944/landing. DisableGuest Mode and thenSave.

NOTE: Make sure to use your LAN IP here (192.168.1.xx or similar), not your WAN/external IP. This should resolve to your server only within your local network.

You now need to register your Chromecast devices as developer devices. For each device, locate the Serial Number (located on the back of the device and on the box), clickAdd New Device, and enter the Serial Number and a brief Description. (NOTE: This may take up to 15 minutes to take effect. Go grab a cup of coffee and then head back.)

Installation is a snap with NPM.

npm i multicast -gmulticast configmulticast start

Head over tohttp://YOUR_LOCAL_IP:3944/ in your browser to get started, then simply follow theUsage guide to get off the ground.

For development, you can install locally via Github - clone this repository to your local machine, then head into the cloned directory and create a.config file for your setup.

git clone https://github.com/superhawk610/multicastcd multicastcp .config.template .configvim .config

NOTE: You should leavemongoAuthSource andmongoPort set to their default unless you know what you're doing.

Install Node modules

npm install

Build files using Gulp

gulp

Run the application

node.

In order for a Chromecast to establish and maintain a connection with a Cast sender, the sender must open two ports:

1900/UDP (DIAL) 5353/UDP (mDNS)

Make sure that the device running MultiCast has these ports open, as well as the standard HTTP ports

80/TCP/UDP (HTTP) 443/TCP/UDP (HTTPS)

--serve-only - Do not attempt to connect to any devices, just serve files via Express. Useful for debugging.

*** WARNING *** The program 'nodejs' uses the Apple Bonjour compatibility layerof Avahi. *** WARNING *** Please fix your application to use the native API ofAvahi! *** WARNING *** For more information seehttp://0pointer.de/avahi-compat?s=libdns_sd&e=nodejs *** WARNING *** The program'nodejs' called 'DNSServiceRegister()' which is not supported (or only supportedpartially) in the Apple Bonjour compatibility layer of Avahi. *** WARNING ***Please fix your application to use the native API of Avahi! *** WARNING *** Formore information seehttp://0pointer.de/avahi-compat?s=libdns_sd&e=nodejs&f=DNSServiceRegister

Don't worry about this. This warning shows up in all Node apps on Linux that depend onlibavahi-compat-libdnssd-dev. You can safely ignore it.

Can't launch after installing via NPM?Make sure yourNODE_PATH environment variable correctly includes the global store for node dependencies. On Linux:

export NODE_PATH=/opt/lib/node_modules

Multicast can't find your devices?Make sure they've already been setup and powered on and the display that they're connected to is powered on and displaying their output.

If you can view them from other Cast-enabled apps but not from Multicast, its likely an issue with your firewall. Make sure you configured your firewall correctly (seeFirewall Settings).

Using Node 8.6+?

EDIT: This has been patched as of node_mdns 2.3.4. This fix is no longer required.

The most recent version of node_mdns has an incompatibility with v8.6 due to changed syntax for a method (seethis pull request). Until it is fixed in the main branch, you will need to patch it yourself. Editnode_modules/mdns/lib/resolver_sequence_tasks.js and make the following change (roughly line 115):

   function getaddrinfo_0_11(host, family, cb) {     var req = new cares.GetAddrInfoReqWrap()-      , err = cares.getaddrinfo(req, host, family)+      , err = cares.getaddrinfo(req, host, family, 0, false)       ;     req.oncomplete = function oncomplete(err, addresses) {         getaddrinfo_complete(err, addresses, cb);

Running CentOS and Seeing This Error?

Error: getaddrinfo -3008

Make sure you havenss_mdns installed:

sudo yum install nss_mdns

If you run into any problems while using this, please report themhere.

Aaron Ross -author -superhawk610

Brekmister -contributor

Mark Stenglein -contributor -ocelotsloth

Andrew Pryor -contributor -andrewpryor

• NEW: Use a code editor that supportsPrettier and the included.prettierrc.yml
• Follow the existing code formatting (2 spaces, not tabs, no hanging brackets, no semicolons, etc)
• Comment your code to explain anything more complex than a routine action
• Provide rationale for any changes you request
• Use thorough commit/pull request messages

main (stable) all features in this branch are fully implemented and ready to go

api (unstable) this branch implements receiver grouping and remote control by splitting all functions out into an independent REST API

rotation (stable) this branch adds the ability to display channels at 90/180/270 degress of rotation

authentication (unstable) this branch adds a login page and POST/DELETE request verification

logging (unstable) this branch adds real-time logging & monitoring of all console/page-load errors from receiver devices back to Multicast's web interface

Creating a channel layout is simple, and consists of two things:

CSS Layout

Copyapp/views/layouts/template.pug and change the name to your new channel layout name (e.g. -my-layout.pug).

Change the class applied to the body to the name of your channel layout (e.g. -body.my-layout).

Inbuild/css/channel.css, add rules to style eachiframe in your layout, prefixing each withbody.layout-name, replacinglayout-name with your layout name. Refer to the existing rules for inspiration.

NOTE: Channel sections are currently limited to 4 per channel. To increase this, changemaxSectionCount onapp/views/channel.pug.

CSS Icon Design

Inapp/views/channel.pug, add a div under#channel-layout with the classlayout andlayout-name, again replacinglayout-name with your layout name. Make sure this div has the classactive when the channel is using your layout, as such:

.layout.layout-name(class=(channel && channel.layout == 'layout-name' ? 'active' : ''))

Style this div inbuild/css/channel-edit.css to conform to the existing channel layouts:

width:250px;height:150px;border:1px solidrgb(202,206,215);

Once you finish, don't forget togulp everything to apply your new layout.

This project relies onnode-castv2 which uses an outdated version ofprotobuf. I am in the process of getting this vulnerability patched - current status is trackedhere. Details of the vulnerability can be foundhere.

This project is licensed under the MIT License - seeLICENSE for more details.

Special thanks toGreenscreen and the team over at Groupon for inspiring this product.