Welcome! This guide will explain how to enable Keysight's built in note counter and/or pedal display, and configure their style and position.

Requirements

None!

Process

Turning on note counter and pedal display

Both the note counter and pedal display are unique in Keysight in that they can only be enabled using console commands. In the System tab, there is a semi-transparent text input field for entering console commands:

Entering the text counteron will turn on the note counter, and entering pedalson will turn on the pedal display. counteroff and pedalsoff will turn these off again.

Configuring note counter style and layout

The counter and pedal style and position is pre-configured to "just work" according to what I think looks pretty good, but they can be resized, recoloured and repositioned as needed with more console commands.

Note counter style

The note counter style command is as follows (brace yourself):

counter [session/total/subathon],[digits],[digit size],[alignment TL/T/TR/L/M/R/BL/B/BR],[X-offset]x[Y-offset],[background colour],[foreground colour],[opacity]

So as an example, the default style is:

counter session,5,40,TL,20x20,#333333,#FFFFFF,0.25

Alignment letters specify which side or corner of the screen the counter is pinned to. In order, they correspond to: top-left, top-middle, top-right, left-middle, middle, right-middle, bottom-left, bottom-middle, bottom-right.

Note counter modes and extra commands

To further explain the functionality of that first variable:

• session: displays notes played in this Keysight session (typically this begins counting immediately once Keysight is open)
• total: displays all notes tracked with the Statistics tab
• subathon: counts down from a given value, and makes Keysight turn completely black (other than the 0 counter) once the counter hits zero

Extra session commands

• counternewsession: takes the current session-mode count and applies it as an offset, causing the counter to begin counting from 0 again. Useful for keeping track of the number of notes in a specific piece!
• counteroffset: applies a manual note count offset, similar to newsession but using an arbitrary number instead of whatever the current count is
• counterresetsession: resets any newsession offsetting so the session counter displays all session notes once more

Extra subathon commands

This mode is intended to heavily integrate with a custom chat control system, where event data (like subscriptions) from your stream can inject more notes into the counter.

• countermax: sets a maximum number of notes that the subathon counter can hit (off by default)
• counteradd [number]: adds the given number to the counter. Can be negative to subtract amounts
• counterset [number]: manually set the counter to a specific number
• counterquery: (also works in session mode) sends the current counter value over the Inbound websocket (if connected), via the counter event name, with variable name counter

Configuring pedal display style and layout

This works very similarly to the note counter, with a few different parameters:

pedals [soft],[sostenuto],[sustain],[squash proportion],[vertical size],[alignment TL/T/TR/L/M/R/BL/B/BR],[X-offset]x[Y-offset],[background hex],[inactive pedal colour],[active pedal colour],[opacity]

The default style is:

pedals 1,1,1,0.9,40,TL,60x60,#333333,#666666,#FFFFFF,0.25

The first three numbers can be 0 or 1 to disable or enable the corresponding pedal. "Squash proportion" is the amount of Y-axis scaling applied to the pedals when they are active. Pedals also blend between the inactive and active pedal colours with activity.

Worth noting is that each pedal uses the given size in the Y-axis, but the X-axis is 3/4 of the given size. A size of 40 will give each pedal a size of 30x40, so a full set of three pedals would become 90x40.

Automatically applying settings on Keysight startup

These commands can be saved into a file that Keysight reads upon launch, and executed automatically. This saves you having to type in style commands every time, which would be ridiculously annoying!

In order to do this, navigate to your save data found at:

• Windows: C:\Users\you\AppData\Local\Keysight\Saved\
• MacOS: Library/Application Support/Epic/Keysight/Saved/

And edit the commands.txt file in any text editor. Any lines you add will be executed as console commands, so using the default styles as an example, adding:

counteron
counter session,5,40,TL,20x20,#333333,#FFFFFF,0.25
pedalson
pedals 1,1,1,0.9,40,TL,60x60,#333333,#666666,#FFFFFF,0.25

Would turn on both the note counter and pedal display and also set their styling whenever Keysight launches.