Notebook Customization#

You can customize the appearance of the nocti list command by defining colors in your main .nocti/nocti.json file.

Color Configuration#

Add an optional colors key at the top level of your nocti.json file:

{
  "name": "my-project",
  "version": "development",
  "colors": {
    "file_list_bg": "blue",
    "file_list_fg": "white",
    "preview_pane_bg": "orange",
    "preview_pane_fg": "white"
  },
  ...
}

Supported Colors#

The following color names are supported (assuming your terminal has 256-color support):


`black`	`red`	`green`	`yellow`
`blue`	`magenta`	`cyan`	`white`
`gray`	`darkgray`	`lightgray`	`silver`
`brightred`	`brightgreen`	`brightyellow`	`brightblue`
`brightmagenta`	`brightcyan`	`brightwhite`	`orange`
`darkorange`	`pink`	`hotpink`	`purple`
`violet`	`brown`	`navy`	`teal`
`olive`	`maroon`	`aqua`	`fuchsia`
`lime`	`skyblue`	`gold`	`indigo`
`coral`	`turquoise`	`plum`	`orchid`
`salmon`

Default Colors#

If no colors are defined, the following defaults are used:

file_list: blue
preview_pane: orange

Editor Configuration#

You can customize which editor is used when you press ENTER on a file in the list.

Setting the Editor#

Add an editor key at the top level of your main .nocti/nocti.json file or a specific resource’s .nocti.json file:

{
  "name": "my-project",
  "version": "development",
  "editor": "nvim",
  ...
}

If no editor is specified, Nocti defaults to nano. Newly created resources inherit the editor setting from the main configuration.

Previewing Files#

When using nocti list inside a notebook, you can:

Navigate the file list using Up/Down arrow keys.
Switch focus to the preview pane using TAB.
Scroll the preview content using Up/Down arrow keys, PgUp, or PgDn when the preview pane is focused.
Exit the interactive mode by pressing q.