Themes

The default appearance of the application can be modified by:

• Specifying the theme file (--set-theme)
• Specifying the theme configuration (--set-theme-config)

Both these options can be set in the config file (~/.config/bluetuith/config) as follows:

set-theme=<theme>

or

set-theme-config=[modifier1=element1,modifier2=element2,...]

It is not recommended to use both of the options at the same time.

Theme configuration

A theme configuration is a comma separated list of modifier-color pairs. For example:

Adapter=blue,Device=pink,Background=transparent,Border=white,Menu=green,MenuItem=purple

This theme configuration can be set via the command-line as follows:

bluetuith --set-theme-config='Adapter=blue,Device=pink,Background=transparent,Border=white,Menu=green,MenuItem=purple'

or, in the config file as:

set-theme-config='Adapter=blue,Device=pink,Background=transparent,Border=white,Menu=green,MenuItem=purple'

To see the list of available modifiers and colors, type bluetuith --help.

Modifiers

Adapter

Set the adapter name's color on the menubar as well as the adapter selector popup.

Device

Sets the device name's color in the device list.

DeviceConnected

Sets the device name's color when it is connected.

DeviceDiscovered

Sets the device name's color when it has been discovered during a scan.

DeviceType

Sets the device type's color in the device list.

DeviceProperty

Sets the device property's color in the device list.

DevicePropertyConnected

Sets the device property's color when it is connected.

DevicePropertyDiscovered

Sets the device property's color when it has been discovered during a scan.

MenuBar

Sets the color for the menubar.

Menu

Sets the color for the menu buttons.

MenuItem

Sets the color for the menu options.

ProgressBar

Sets the color for the progress bar during a file transfer.

ProgressText

Sets the color for the progress bar's description.

StatusInfo

Sets the color for the info messages in the statusbar.

StatusError

Sets the color for the error messages in the statusbar.

Text

Sets the color for the:

• Help popup
• The input field's text
• The progress view's title
• The file picker's title, and file names

Background

Sets the background color.

Border

Sets the border color for the the menu option list, adapter selector and help popups.

Theme file

A theme file contains a theme configuration, where each modifier-color pair are separated by a newline. Single line comments are allowed.

A theme file is usually stored in ~/.config/bluetuith/themes.

The following is an example of a valid theme file:

# Light theme

# Adapter color
Adapter=black

# Device colors
Device=black
DeviceConnected=black
DeviceDiscovered=orange

# Menu colors
MenuBar=white
Menu=black
MenuItem=black

# Progress colors
ProgressText=black
ProgressBar=black

# Extra colors
Text=black
Border=black
Background=white
StatusInfo=black

This configuration is stored in ~/.config/bluetuith/themes/light-theme, and is set via the commandline as follows:

bluetuith --set-theme='light-theme'