Skip to content

Configuring & Customizing your Winnitron

Aaron Klaassen edited this page May 1, 2018 · 6 revisions

Custom intro and background videos

Note: this feature is only supported in Launcher version >= 2.3.0 Newer versions are available and backwards-compatible.

Simple: the Launcher looks for intro.mp4 and background.mp4 in the WINNITRON_UserData/Attract folder. Just replace the defaults and you're good to go.

Customizing key bindings

Note: this feature is only supported in Launcher version >= 2.1.0 Newer versions are available and backwards-compatible.

By default, the Launcher is expecting your controls to map to these keys:

Player Movement Button 1 Button 2
1 Arrow Keys . /
2 WASD ` 1
3 IJKL G H
4 Numpad 8456 Numpad 1 Numpad 2
Key Action
ESC Back/Home/Quit

However if you wish to change this, you can do so by modifying the keycodes section of your winnitron_options.json file. Any controls not listed in the options file will use the default key.

A complete list of valid key values is available here.

e.g.,

"keycodes": {
  "player1": {
    "up": "Up",
    "down": "Down",
    "left": "Left",
    "right": "Right",
    "button1": ".",
    "button2": "/"
  },
  "player2": {
    "up": "w",
    "down": "s",
    "left": "a",
    "right": "d",
    "button1": "`",
    "button2": "1"
  },
  // ...
}

Games can also specify their own key maps; the translation between the games' keys and your Winnitron's is taken care of by the Launcher sync. So don't even worry about it.

Attract screens

Put pngs, mp4s, or txt files in WINNITRON_UserData/Attract. Template to match existing pngs here.

Only pngs are supported pre-v2.3.0.

Jukebox

Put ogg files in WINNITRON_UserData/Music But we have some music for you right here, if you want.

Logging options

Remote logging (optional)

By default the Winnitron Launcher writes log output to WINNITRON_Data/output_log.txt. However if you wish you can also point your Winnitron at Loggly.com. Sign up for an account there, get an API key, and fill it in in your winnitron_options.json file under logger -> token. i.e.,

"logger": {
  "token": "YOUR LOGGLY API KEY HERE",
  "level": "info"
 }

Log levels

If you wish to filter the logs being written (or maybe you want to see everything?), you can change the default log level. There are four options: debug, info, warn, and error. Default is info.