Color themes

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

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.

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.

Customizing Built in Themes

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

Darkness

Skylight

Sandy Beach

Darktooth

Creamsody

Purple Haze

Verdant

Amber Cathode

macOS

macOS Graphite

StandardDark

images/standard-dark.png