/speedcontrol-gdqtracker

NodeCG bundle working with nodecg-speedcontrol to get donations/bids from GDQ donation tracker.

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

speedcontrol-gdqtracker

Description

This is a NodeCG bundle intended to be used on top of Speedcontrol. It provides extra functionality for pulling the current donation total and upcoming open bids from the GDQ donation tracker, if you're using it.

This bundle is intended to be used in conjunction with Speedcontrol, but does not provide any actual graphics for your layouts. You need to make these yourself in a separate bundle of your own.

Bundle Config File

The config schema for this bundle has the donation tracker settings. See configschema.json for the definitions.

Getting Started

1. Install Node.js

Instructions on the Node.js site here: https://nodejs.org/en/

NOTE: At time of this writing, the current LTS version is 10.13 and NodeCG recommends sticking with the LTS releases for production. It should work with the current stable version as well, which is 11.2 currently, but you'll have to test this yourself.

2. Install NodeCG modules

Follow the quick start guide here: https://nodecg.com/tutorial-3_quick-start.html

Do steps 1-3 to install the bower and nodecg-cli packages.

3. Make a working directory and install NodeCG

Create a fresh directory, and run the NodeCG setup in it:

nodecg setup

4. Install bundles

Install both the Speedcontrol bundle and this one from GitHub using the following commands:

nodecg install speedcontrol/nodecg-speedcontrol
nodecg install PowerUpWithPride/speedcontrol-gdqtracker

This will create a bundles subfolder inside your new directory that contains git repositories of these two bundles. You can now make whatever changes and tweaks you like from that location.

5. Generate config files

You can generate default config files for the bundles based on their config schemas:

nodecg defaultconfig nodecg-speedcontrol
nodecg defaultconfig speedcontrol-gdqtracker

This will create a new subdirectory called cfg for the config files.

You can check out the JSON config files from the config files repository for NodeCG and Speedcontrol themselves to see exactly what settings we're using. You should copy the Speedcontrol one at least, because that includes the Twitch integration settings.

6. Run the server locally to test

In the directory where you ran setup initially, run the following:

nodecg start

The server should run on localhost:9090 by default. You can open this location in your web browser and start experimenting.

7. Running in production

To run NodeCG in production, pm2 is recommended.