Configuration

You can copy the supplied sample-config to your home directory and move it to

``$XDG_CONFIG_HOME/bpython/config`` [#f1]_. bpython tries to find

``$XDG_CONFIG_HOME/bpython/config`` and use it as its configuration, if the

file does not exist bpython will use its documented defaults.

.. [#f1] ``$XDG_CONFIG_HOME`` defaults to ``~/.config`` if not set.

General

This refers to the ``[general]`` section in your `$XDG_CONFIG_HOME/bpython/config` file.

auto_display_list

If the pastebin supports a private option to make a random paste id, use it.

Default: True).

.. versionadded:: 0.12

pastebin_show_url

The url under which the new paste can be reached. ``$paste_id`` will be

An example helper program is ``pastebinit``, available for most systems.

.. versionadded:: 0.12

.. _configuration_color_scheme:

color_scheme

See :ref:`themes` for more information.

Color schemes should be put in ``$XDG_CONFIG_HOME/bpython/``

e.g to use the theme ``$XDG_CONFIG_HOME/bpython/foo.theme`` set ``color_scheme = foo``

If you set the colorscheme to `foo` this will be translated to

``$XDG_CONFIG_HOME/bpython/foo.theme`` so be sure to put the file in that directory.

Leave blank or set to "default" to use the default (builtin) theme.

Keyboard

This section refers to the ``[keyboard]`` section in your ``$XDG_CONFIG_HOME/bpython/config``.

You can set various keyboard shortcuts to be used by bpython. However, we have yet to map all keys

to their respective control codes. If you configure a key combination which is not yet supported

by bpython it will raise an exception telling you the key does not exist in bpython.keys.

Valid keys are:

* Control + any alphanumeric character (C-a through A-z, also a few others).

* Any function key ranging from F1 to F12.

GTK

This refers to the ``[gtk]`` section in your `$XDG_CONFIG_HOME/bpython/config` file.

font