Generally, bluetuith will work out-of-the-box, with no configuration required.

In case you need to specify settings without using command-line options, a config file can be used.

Typing bluetuith --help will show you the location of the config file.

The configuration file is in the HJSON format. You can use the –generate flag to generate the configuration.

For example:

{
  adapter: hci0
  receive-dir: /home/user/files
  keybindings: {
  	Menu: Alt+m
  }
  theme: {
  	Adapter: red
  }
}

#Keybindings

The keybinding configuration is a list of KeybindingType: keybinding values.

While defining keybindings, the global keybindings must not conflict with the non-global ones.
It is possible to have duplicate keybindings amongst various non-global keybindings, provided
they are not part of the same context.

For example, this is allowed:

keybindings: {
	FilebrowserSelect: Space
	PlayerTogglePlay: Space
}

But this isn’t:

keybindings: {
	Menu: Alt+m
	Close: Alt+m
}

#Modifiers

The modifiers currently supported for keybindings are Ctrl, Alt and Shift. Shift should only be used in rare cases. For example, instead of :

• Shift+a, type A
• Alt+Shift+e, type Alt+E

and so on.

For the ‘+’ and the space characters, type Plus and Space respectively. For example,

keybindings: {
	AdapterChange: Ctrl+Plus
	PlayerStop: Ctrl+Space
}

#Types

Note that some keybinding combinations may be valid, but may not work due to the way your terminal/environment handles it.

The keybinding types are as follows:

#Themes

The theme configuration is a list of ElementType: color values.
Color names or hexadecimal values can be provided for each element type.

For example:

theme: {
	Adapter: red
	Device: #000000
}

To get a list of available element types and colors, use the --help command-line option.