navi/docs/customization.md
2020-08-29 18:58:55 -03:00

1.8 KiB

Customization

Changing colors

You can change the color scheme by overriding fzf options.

In addition, you can change the text color for each column by setting the following environment variables:

  • $NAVI_TAG_COLOR
  • $NAVI_COMMENT_COLOR
  • $NAVI_SNIPPET_COLOR

The values go from 0 to 15.

For example, if you add the following your .bashrc-like file, the comment color will be yellow:

export NAVI_COMMENT_COLOR=3

Resizing columns

You can change the column widths by setting the following environment variables:

  • $NAVI_TAG_WIDTH
  • $NAVI_COMMENT_WIDTH

The values go from 0 to 100 and represent the percentage the column will occupy.

For example, if you add the following your .bashrc-like file, the comment column will be very small:

export NAVI_COMMENT_WIDTH=5

Overriding fzf options

Let's say you want to override $FZF_DEFAULT_OPTS with --height 3.

This can be overridden in the following ways:

# if you want to override only when selecting snippets
navi --fzf-overrides '--height 3'

# alternatively, using an environment variable in your .bashrc-like file:
export NAVI_FZF_OVERRIDES='--height 3'

# if you want to override only when selecting argument values
navi --fzf-overrides-var '--height 3'

# alternatively, using an environment variable in your .bashrc-like file:
export NAVI_FZF_OVERRIDES_VAR='--height 3'

# if you want to override for all cases
FZF_DEFAULT_OPTS="--height 3" navi