A digital signage solution using the Web and Chromecast devices.
Built with Angular.js, Node.js, Express.js, and CouchDB.
How to Use
On the homepage, you will find several options currently at your disposal, namely:
- Channel Takeover
Chromecasts tune into 'Channels', which refer to certain URLs.
Create a channel by clicking the 'Add a Channel' button.
Here, you can specify the name of your channel as well as the URL it points to.
You can also choose to serve multiple URLs, which rotate at a specified time interval.
To edit a channel, click the name of your channel and adjust accordingly.
Here, you can browse the available chromecasts. Click 'Add a chromecast' to connect a new Chromecast.
You can also preview what that Chromecast is tuning into, by clicking 'Preview.'
You will be prompted by the Google Cast extension to select a Chromecast. Select one of the available devices.
This will automatically populate the 'Name' field with the name of the Chromecast.
Describe the location of the Chromecast in the 'Location' field.
From the dropdown, select the channel that you want that chromecast to view.
You can edit a Chromecast by clicking a Chromecast's name. From here, you can edit the location and the channel.
That Chromecast will be automatically updated with that location and channel.
In the case that a Chromecast becomes disconnected, you can also reconnect a Chromecast by clicking 'Reconnect.'
Just like adding a Chromecast, you can select the appropriate Chromecast, and it will associate itself with the current
You can also push an alert to all Chromecasts using 'Push Alert'.
Here, you can specify the alert's content, its type, and its duration.
Clicking 'Push Alert' will publicize this alert on all pages. Any subsequent alerts will currently override the current alert.
Here, you can do a 'Channel Takeover' to set all Chromecasts to a specific channel, and also choose to stop said takeover.
Getting Started: Local
To install dependencies:
brew install couchdb npm install
You must also have the Google Cast Chrome extension, as well as a Chromecast setup application.
You'll also need at least one Chromecast :)
Registering your Application
In order for your Chromecast to properly receive our Custom Receiver, your must first
register your Cast Application.
Following the instructions, you should sign into the Google Cast SDK Developer Console,
create a new application, and select Custom Receiver.
In the URL field, you will need to provide a URL to the application.
By default, the URL you want will be:
For OS X, you can find your local IP in System Preferences > Network, and will generally begin with
Registering your Chromecasts
Along with registering your Chromecast Application, you will need to register your Chromecasts. This is done through the
Google Cast SDK Developer Console.
Serial numbers can be found on the back of your Chromecast. Once registration is complete, make sure to reboot your devices, which
can be done through the Chromecast Desktop Application.
Setting up your Chromecasts
Set up your chromecasts using the Chromecast Setup Application, through mobile or desktop (Desktop preferred).
Make sure that they are on the same Wi-Fi network as your local machine.
Make sure that each Chromecast is configured to send its ID number via the Chromecast App. In the desktop application,
this involves checking the box that says to 'Send this Chromecast's serial number to Google when checking for updates'.
Once that preference is saved, it may be useful to reboot your chromecast. Doesn't hurt!
You will need to create and edit some config files.
npm run create-config
public/js/gscreen-config.js, edit the
chromecastApplicationId field to your Chromecast Application ID.
You can configure the couchDB and sever details in config.json.
Starting the Server
Phew! Now that all of that yucky registration is done, you're ready to start the Greenscreen server.
Start up couchdb with:
Start the server with:
(Optional) You can seed the database with dummy chromecasts.
npm run seed
View the project locally at http://localhost:4994.
The client-side code is bundled from the
src/client directory. To build, run:
npm run bundle
This will watch all changes to client side code, and bundle it to public/js/gscreen.js.
public/js/gscreen.js is automatically generated, so don't edit this file!
While the server is running with
npm start, changes in the
src/server will cause the server to restart
with the new changes.
End-to-end tests are run using protractor. To start tests:
You will need protractor installed:
npm install -g protractor
Start up the application locally, and then:
Start a webdriver-manager:
npm run webdriver
Start the tests:
When adding a Chromecast, the Chrome extension may time out on requesting a Session, though the Chromecast may successfully
display the 'Setting up Chromecast' page. This timeout occurs because connecting to your local server tends to be pretty slow.
To remedy this, select the Chromecast in the Google Cast extension, and select 'Stop Casting.' You'll need to
navigate back to the Chromecasts list, and click 'Add new Chromecast' to try again.
My Chromecasts aren't appearing in the Google Cast extension!
Make sure that you are able to see your Chromecast(s) in the Google Cast extension on other tabs/pages. If not, this is
most likely an error with your extension, or your connection.
- Check that your Chromecast and your local development server are on the same Wi-Fi network
- Try rebooting your Chromecasts through the desktop applications or manually, and reconnecting them.
- Try restarting your Chrome browser (Completely quit the application and re-open)
When all else fails, reboot your chromecasts, and restart Chrome.
Obviously, you don't neccessarily want to have everyone able to manipulate every Chromecast through the web
interface. Currently, the best way to secure this is by setting up a private Wi-Fi network for the Chromecasts
to connect to.