Configure jdig

jdig reads its settings from a tui.toml file when it starts. Without the file, it uses the defaults below.

Configuration file location

System	File
Windows	%APPDATA%\json-digger\tui.toml
macOS	~/Library/Application Support/json-digger/tui.toml
Linux	~/.config/json-digger/tui.toml, or $XDG_CONFIG_HOME/json-digger/tui.toml

Create the folder and the file if they do not exist.

Settings

This file sets every value to its default:

tui.toml

panel_ratio = 0.55
mouse_enabled = true

[colors]
string = "green"
number = "yellow"
boolean = "magenta"
null = "dark_gray"
key = "cyan"
bracket = "white"

Setting	Does	Default
panel_ratio	The share of the width taken by the tree, from 0.2 to 0.8. [ and ] change it while jdig runs, until you quit.	0.55
mouse_enabled	Lets you click rows and scroll with the mouse wheel	true
[colors]	The colors of strings, numbers, booleans, null, keys, and brackets in the tree	See above

Colors are names: black, red, green, yellow, blue, magenta, cyan, white, gray, dark_gray, and light_red, light_green, light_yellow, light_blue, light_magenta, light_cyan. Hex values such as #ff8800 are not supported.

jdig ignores mistakes in the file without a message: an unknown color becomes white, and invalid TOML makes jdig use every default. If your settings seem to have no effect, check the file for typos.

Turn off colors

To turn off the colors of values, set the NO_COLOR environment variable to any value:

NO_COLOR=1 jdig data.json

The selection and the status bar keep their colors.