Settings

Tips: Ctrl + R will reread and reload the config and sprites for the current bongo.exe process.

The following settings is the default one. You can change which ever configurations you want to in the config.json file within the same folder as the bongo.exe file. For example:

{
    "mode": 2,
    "decoration": {
        "rgb": [0, 0, 255]
    }
}

will change the current playing mode to osu!taiko, set the background to dark blue, while maintaining every other default configurations. Note that, if config.json is not found in the folder, the default settings is used.

{
    "mode": 1,
    "resolution": {
        "letterboxing": false,
        "width": 1920,
        "height": 1080,
        "horizontalPosition": 0,
        "verticalPosition": 0
    },
    "decoration": {
        "leftHanded": false,
        "rgb": [255, 255, 255],
        "offsetX": [0, 11],
        "offsetY": [0, -65],
        "scalar": [1, 1]
    },
    "osu": {
        "mouse": true,
        "key1": [90],
        "key2": [88],
        "smoke": [67]
    },
    "taiko": {
        "leftCentre": [88],
        "rightCentre": [67],
        "leftRim": [90],
        "rightRim": [86]
    },
    "catch": {
        "left": [37],
        "right": [39],
        "dash": [16]
    },
    "mania": {
        "4K": true,
        "key4K": [68, 70, 74, 75],
        "key7K": [83, 68, 70, 32, 74, 75, 76]
    }
}

General

mode: Current playing mode: 1 for osu!, 2 for osu!taiko, 3 for osu!catch, 4 for osu!mania. Currently, all values from 1 to 4 is supported.

Resolution

• letterboxing: Whether osu! is using letterboxing or not.
• width: osu! width resolution. (I highly recommend changing this one into your desired value)
• height: osu! height resolution. (Also highly recommended to be changed)
• horizontalPosition: osu! horizontal position. Leave this at 0 if you're not using letterboxing.
• verticalPosition: osu! vertical position. Leave this at 0 if you're not using letterboxing.

Decoration

• leftHanded: Whether you are left-handed or not. If set to true then flip the scene horizontally in OBS.
• rgb: An array containing three values (red, green, blue respectively) describing the desired background's RGB values.
• offsetX, offsetY, scalar: Parameters to calibrate the device's position and scaling. The first integer in each list is for calibrating the mouse (i.e. mouse.png), while the second is for calibrating the tablet (i.e. tablet.png).

osu! mode

• mouse: Whether you are using a mouse.
• key1, key2: arrays containing virtual key-codes of your Key 1 and Key 2 accordingly. Use this page to find your key-codes. For example, if key1 contains 90 and 65 corresponding to Z and A key (i.e. "key1": [90, 65]), then each of these keys will trigger the left-key-press animation.
• smoke: arrays containing virtual key-codes of your smoke key.

Warning: key1 and key2 must not contain similar values.

osu!taiko mode

• leftCentre: an array containing virtual key-codes of your left centre key.
• rightCentre: an array containing virtual key-codes of your right centre key.
• leftRim: an array containing virtual key-codes of your left rim key.
• rightRim: an array containing virtual key-codes of your right rim key.

Warning: leftCentre and leftRim must not contain similar values; rightCentre and rightRim must not contain similar values.

osu!catch mode

• left: an array containing virtual key-codes of your left key.
• right: an array containing virtual key-codes of your right key.
• dash: an array containing virtual key-codes of your dash key.

Warning: left and right must not contain similar values.

osu!mania mode

Currently, only osu!mania 4K and 7K are supported.are

• 4K: Whether you are playing 4K mode (then set this to false), or 7K mode (set this to true).
• key4K: an array containing 4 virtual key-codes of your 4K mania bindings.
• key7K: an array containing 7 virtual key-codes of your 7K mania bindings.