The on-screen graphics used during European Speedrunner Assembly's "marathon" events.
This is a bundle for NodeCG; if you do not understand what that is, we advise you read their website first for more information.
This documentation isn't fully complete and may have errors, but intends to be as correct as possible.
This is a NodeCG v1.8.1 bundle. You will need to have NodeCG v1.8.1 or above installed to run it. It also requires you to install the nodecg-speedcontrol bundle (of which you may also need to install the latest changes instead of the most stable release).
You will need Node.js (16.x LTS tested) and git installed to install NodeCG, then see the NodeCG documentation on how to install that. I also suggest installing nodecg-cli; information on that is also on the documentation just linked (the guide below will assume you have done this!). You may also need to install the appropriate build tools for whichever platform you are running on; for example if you are on Windows you can either install it while installing Node.js, or using windows-build-tools.
Next, clone the build branch of this repository into the NodeCG bundles folder and install the dependencies:
cd bundles git clone https://github.com/esamarathon/esa-layouts.git --branch build cd esa-layouts npm install --production
You will probably also want a default configuration you can fill in, which can be created using:
nodecg defaultconfig.
Then, to get the most recent changes for nodecg-speedcontrol, clone the build branch and install dependencies, similar to above:
cd .. git clone https://github.com/speedcontrol/nodecg-speedcontrol.git --branch build cd nodecg-speedcontrol npm install --production
In addition, to have the videos assets automatically audio normalised, you must have python (v3), ffmpeg, and ffmpeg-normalize available in your system's PATH. If you don't have all of these, the check will fail and videos will just not be touched. For Windows, python (v3) should be automatically installed when you install Node.js built tools, if you chose to do that.
Not everything you can set is documented here; if you're an advanced user we advise you take a look at the included configschema.json file.
This bundle heavily relies on the obs-websocket plugin, so make sure you have this installed (custom address/port and password can be specified in the bundle's config if needed).
This bundle also heavily relies on information from a RabbitMQ server, and an instance of our fork of the GamesDoneQuick donation tracker.
Included with this bundle is a plugin for the Elgato Stream Deck software that can be used by various crew members during events. Once you have the Stream Deck software installed, you can install the plugin by running the file com.esamarathon.streamdeck.streamDeckPlugin in the streamdeck-plugin/Release directory. Currently, you need to set the actions up yourself in the software, so it can easily be customised on the fly.
You will need to install the speedcontrol-flagcarrier bundle to use this part, along with using one of the FlagCarrier applications to set them.
Hosts (the ones on camera):
- group_id:
hosts - positions:
left,midleft,middle,midright,right
This can be enabled via the config, controlled via Stream Deck buttons available in the included extension, and the graphic files tts.html will play them when requested. You will need to set a specific URL for the voiceAPI setting in the config though, so unless you know this it's somewhat useless, sorry.
This bundle can interface with foobar2000 using the beefweb plugin. Set up foobar2000 however you want it to play music (we use a long playlist on shuffle, and set a fade in/out on pause), make sure the correct username/password are set in the configuration fiole, and this bundle with automatically play music when needed. It will only play if the scene name ends in [M], for example, Intermission [M].
Here's a list of events this bundle has been used at so far, most recent first.
- UKSG Autumn 2021
- ESA Summer 2021
- UKSG Summer 2021
- UKSG Spring 2021
- ESA Winter 2021
- UKSG Winter 2021
- UKSG Autumn 2020
- ESA Summer 2020
- UKSG Summer 2020
- ESA Corona Relief
- ESA Together
- UKSG Spring 2020
- ESA Winter 2020
- UKSG Winter 2020
- ESA @ Malmö Vinterspelen 2019
- ESA @ DreamHack Winter 2019
- UKSG Autumn 2019
- ESA Summer 2019 (including some streams on SpeedGaming during the event).
- UKSG Summer 2019
- All BSG's from BSG @Home 2020 onwards (Aug 2020)
- All Hekathon events from 2021 onwards
Here's a list of previous bundles that used to fulfil the purpose of this one, when we kept making new repositories for most of them.
- esaw19-layouts
- ESA Winter 2019
- ESA @ TwitchCon Europe 2019
- esas18-layouts
- ESA Summer 2018
- UKSG Fall 2018
- ESA Movember
- UKSG Winter 2019
- UKSG Spring 2019
- esaw18-layouts
- ESA Winter 2018
- esa17-layouts
- ESA 2017
- Country flags sourced from speedrun.com.
- clip.ts, modified from a version originally written by Hoishin.