Color themes

CutBox has several color themes to choose from, use Cmd + t to cycle through them or pick one in preferences.

Built in color themes

Darkness

Skylight

Sandy Beach

Darktooth

Creamsody

Purple Haze

Verdant

Amber Cathode

macOS

macOS Graphite

StandardDark

User created themes.

From CutBox v 1.4.18 you can use custom themes.

Themes are in a JSON format and stored in ~/.config/cutbox/ as files with the extension .cutboxTheme.

You can access the built in themes at https://github.com/cutbox/CutBox/tree/master/CutBox/CutBox/themes

The JSON format is as follows.

{
    "name": "Darkness",
    "popupBackgroundColor": "#163242AA",
    "searchText": {
        "cursorColor": "#0E1C20",
        "textColor": "#0E1B21",
        "backgroundColor": "#ECF3F6",
        "placeholderTextColor": "#ADC3CC"
    },
    "clip": {
        "backgroundColor": "#0E1B21",
        "textColor": "#ACC0CA",
        "highlightColor": "#033E60",
        "highlightTextColor": "#ACC0CA"
    },
    "preview": {
        "textColor": "#ADC2CC",
        "backgroundColor": "#060707",
        "selectedTextBackgroundColor": "#163242",
        "selectedTextColor": "#000000"
    },
    "spacing": 1
}

Color values are hex RGB style, hex RGBA is also usable... e.g.

# rrggbbaa
"#163242AA"

As with the color channels RGB, the A (alpha) channel is set with values from 00-FF. (00 transparent, FF solid.)

If there are errors in your theme, CutBox will not start up. To debug your theme, start CutBox from the terminal. Pay close attention to JSON formatting (validate with https://jsonlint.com/) and property names.

Spacing values can be floating point or integer, setting them too large will look very bad. Between 0 and 4 is ok by me.

# open a terminal window...
/Applications/CutBox/Contents/MacOS/CutBox

CutBox will show error messages here.