Bominade Configuration

Bominade can be configured using the configuration file, or by passing command line options. They both have the same effect, although of course the config file options are easier to maintain.

Configuration file

The default config file is found at ~/.config/b8/b8.ini which will be created for you. If you have set a different user config directory according to XDG, the file will be there instead.

You can choose a different location to find a config file by passing the --config parameter, e.g.:

b8 --config=different-config.ini

The file itself is a standard ini file that follows the conventions of python’s configparser standard module which it uses.

Configuration values

The list of options is gradually growing. Here are the defaults:

[logging]
level = info  # logging level to use

[terminal]
theme = b8  # terminal theme to use
font = Monospace 13  # the terminal font to use, e.g. "Monospace 13"

[shortcuts]
previous-buffer = <Alt>Up  # shortcut key to switch to the previous buffer
next-buffer = <Alt>Down  # shortcut key to switch to the next buffer
previous-terminal = <Alt>Left  # shortcut key to switch to the previous terminal
next-terminal = <Alt>Right  # shortcut key to switch to the next terminal
new-terminal = <Alt>t  # shortcut key to create a new terminal
close-all = <Alt>c  # shortcut key to close all buffers

Command line options

The same configuration values can be passed on the command line, using --{section}-{name} format, e.g.:

b8 --loging-level=error

Additionally there are a number of other flags that can be passed:

$ b8 --help

usage: b8 [-h] [-v] [-d] [-f CONFIG] [-r] [--logging-level LOGGING_LEVEL]
          [--terminal-theme TERMINAL_THEME] [--terminal-font TERMINAL_FONT]
          [--shortcuts-previous-buffer SHORTCUTS_PREVIOUS_BUFFER]
          [--shortcuts-next-buffer SHORTCUTS_NEXT_BUFFER]
          [--shortcuts-previous-terminal SHORTCUTS_PREVIOUS_TERMINAL]
          [--shortcuts-next-terminal SHORTCUTS_NEXT_TERMINAL]
          [--shortcuts-new-terminal SHORTCUTS_NEW_TERMINAL]
          [--shortcuts-close-all SHORTCUTS_CLOSE_ALL]
          [files [files ...]]

The bominade IDE, version 0.2.1

positional arguments:
  files                 files to open

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show the version and exit
  -d, --debug           run with logging level debug
  -f CONFIG, --config CONFIG
                        configuration file to use
  -r, --remote          run a remote command
  --logging-level LOGGING_LEVEL
                        logging level to use
  --terminal-theme TERMINAL_THEME
                        terminal theme to use
  --terminal-font TERMINAL_FONT
                        the terminal font to use, e.g. "Monospace 13"
  --shortcuts-previous-buffer SHORTCUTS_PREVIOUS_BUFFER
                        shortcut key to switch to the previous buffer
  --shortcuts-next-buffer SHORTCUTS_NEXT_BUFFER
                        shortcut key to switch to the next buffer
  --shortcuts-previous-terminal SHORTCUTS_PREVIOUS_TERMINAL
                        shortcut key to switch to the previous terminal
  --shortcuts-next-terminal SHORTCUTS_NEXT_TERMINAL
                        shortcut key to switch to the next terminal
  --shortcuts-new-terminal SHORTCUTS_NEW_TERMINAL
                        shortcut key to create a new terminal
  --shortcuts-close-all SHORTCUTS_CLOSE_ALL
                        shortcut key to close all buffers