Skip to content
Switch branches/tags


Failed to load latest commit information.


📺 Simple self-hosted digital signage software for turning screens into beautiful content displays

Outdated Dependencies Travis Build


Digital Display Preview

Screenshot of the display

Administrator Panel: Changing the widget layout

Screenshot of the administrator panel

Administrator Panel: Slides inside a slideshow

Screenshot of the administrator panel


Use the demo website at (username: demo, password: demo)

How to Run:

  1. Set up a MongoDB installation locally (or in the cloud) and create a digitaldisplay database

  2. Run the setup utility using

npm run setup

and specify the URI to your database.

  1. Install dependencies and run the program
npm install
npm run dev

Updating the software

Assuming the software was cloned from this github repository, it is possible to use the included script

npm run update

which pulls the latest stable version of digital-signage from github, installs dependencies and re-builds the software.


  • Automatic refresh on content change (you should never need to touch a display once set up!)

  • Totally modular, with a comprehensive widget management system (adding a widget is very simple!)

  • Multiple built-in widgets to get you started:

    • Slideshow widget

      Animated screencast of the slideshow widget
    • Weather widget

      Screenshot of the weather widget
    • "Congratulations" widget

      Animated screencast of the congratulations widget
    • Youtube embed widget

    • Web (iframe) widget

      Screenshot of the web widget
    • Standalone image widget

      Screenshot of the image widget
    • Announcements widget

      Screenshot of the announcements widget
    • List widget (can be used a directory, time sheet, etc.)

      Animated screencast of the list widget
  • Flexible, responsive widget grid that allows you to drag, drop and resize widgets

  • Versatile slideshow system that allows multiple slideshows, multiple slide types (images, videos, youtube, web, etc.) inside the same display with variable durations, titles and descriptions for each slide!

  • Support for multiple displays (in progress)

Adding a new widget

Given the highly modular structure of this program, implementing a new widget is a simple task! Simply follow these easy steps to get started:

  1. Create a new folder inside the ​widgets/​ folder, name it according to your widget's name
    (new) MyWidget/

  1. Create an index file inside the newly created folder called index.js ​(extending the​ base_widget ​class) as follows:
import BaseWidget from '../base_widget'

export default class MyWidget extends BaseWidget {
  constructor() {
      name: 'MyWidget',
      version: '0.1',
      icon: ['my-icon'], // Shown in the admin panel
      defaultData: {
         // Your implementation here

The widget's icon should come from FontAwesome.

  1. Implement two React components: Options (renders the dialog that will allow the administrator to change the widget’s configuration) and Widget (renders the user-facing side widget that will be displayed on the TV), return them from getter functions that you add to your index.js file:
export default class MyWidget extends BaseWidget {
  // ...

  get Widget() {
    return (<div>Your implementation here</div>)

  get Options() {
    return (<div>Your implementation here</div>)

  // ...
  1. Finally, when done implementing the widget, register it by adding its folder’s name to the widgets/widget_list.js​ file
module.exports = ['slideshow', 'weather', 'congrats', 'youtube', 'web',
    'image', 'list', 'announcement', /* new */ 'MyWidget']
  1. Restart the server to see the new widget appear on the administrator panel


📺 Simple self-hosted digital signage software for turning screens into beautiful content displays




No releases published


No packages published