top

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
This is the kind of friend you are - without making me realize my soul's anguished history, you slip into my house at night, and while I am sleeping, you silently carry off all my suffering and sordid past in your beautiful hands. b8 loves you.

© 2020

Ali Afshar