X resources

The outlook of program using Detroint engine can be finetuned by user by changing the settings in X resources file. X resources file is located at PREFIX/etc/PROGRAM_NAME.res, and is defined as follows:

!
! The fallback app-defaults for PROGRAM_NAME.
!
! This file will be consulted for visual settings if resources are not present
! in xrdb database, ~/.Xdefaults or ~/.Xresources.
!

!!
! Settings for menus
!!

!
! Color name or color value in a format of #rrggbb or 0xrrggbb is
! supported.
!
PROGRAM_NAME.menu.background:			whitesmoke
PROGRAM_NAME.menu.foreground:			black
PROGRAM_NAME.menu.bgSelected:			gray50
PROGRAM_NAME.menu.bgSelectedHot:		gray60
PROGRAM_NAME.menu.fgSelected:			white
PROGRAM_NAME.menu.fgDisabled:			gray50
PROGRAM_NAME.menu.fgDisabledOverstrikeSize:	0
!
! Margin size in pixels.
!
PROGRAM_NAME.menu.marginWidth:			2
PROGRAM_NAME.menu.marginHeight:			2
!
! Color name or color value in a format of #rrggbb or 0xrrggbb is
! supported. Opaque range is from 0 to 255.
!
PROGRAM_NAME.menu.borderColor:			gray40
PROGRAM_NAME.menu.borderColorOpaque:		64
!
! Gap and separator size in pixels. Opaque range is from 0 to 255.
!
PROGRAM_NAME.menu.gapHeight:			8
PROGRAM_NAME.menu.separatorHeight:		2
PROGRAM_NAME.menu.separatorOpaque:		64
!
! Either tga image file, color name or color value in a format of
! #rrggbbaa or 0xrrggbbaa is supported.
!
!PROGRAM_NAME.menu.borderLeftEdge:		path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderRightEdge:		path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderTopEdge:		path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderBottomEdge:		path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderUpperLeftCorner:	path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderLowerLeftCorner:	path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderUpperRightCorner:	path_to_tga_image_file_here
!PROGRAM_NAME.menu.borderLowerRightCorner:	path_to_tga_image_file_here
!
! Selection border size in pixels.
!
PROGRAM_NAME.menu.hilightBorderWidth:		1
PROGRAM_NAME.menu.hilightBorderHeight:		1
!
! Color name or color value in a format of #rrggbb or 0xrrggbb is
! supported.
!
PROGRAM_NAME.menu.hilightBorderLeftColor:	gray80
PROGRAM_NAME.menu.hilightBorderRightColor:	gray30
PROGRAM_NAME.menu.hilightBorderTopColor:	gray80
PROGRAM_NAME.menu.hilightBorderBottomColor:	gray30
PROGRAM_NAME.menu.hilightBorderLeftHotColor:	gray30
PROGRAM_NAME.menu.hilightBorderRightHotColor:	gray80
PROGRAM_NAME.menu.hilightBorderTopHotColor:	gray30
PROGRAM_NAME.menu.hilightBorderBottomHotColor:	gray80
!
!PROGRAM_NAME.menu.barFontFace:			path_to_font_file_here
PROGRAM_NAME.menu.barFontSize:			14
!PROGRAM_NAME.menu.itemFontFace:		path_to_font_file_here
PROGRAM_NAME.menu.itemFontSize:			14
!PROGRAM_NAME.menu.titleFontFace:		path_to_font_file_here
PROGRAM_NAME.menu.titleFontSize:		14
PROGRAM_NAME.menu.fontDPI:			0
!
! When this is set to 1, string orientation changes from right to left.
!
PROGRAM_NAME.menu.orientation:			0

!!
! Settings for widgets
!!

!PROGRAM_NAME.widget.profile:
!
! Color name or color value in a format of #rrggbb or 0xrrggbb is
! supported. Opaque range is from 0 to 255.
!
PROGRAM_NAME.widget.shadowColor:		#101016
PROGRAM_NAME.widget.shadowOpaque:		192
!
PROGRAM_NAME.widget.sliderSlitColor:		#161913
!
!PROGRAM_NAME.widget.fontFace:			path_to_font_file_here
PROGRAM_NAME.widget.fontSize:			10
PROGRAM_NAME.widget.fontDPI:			0

Each setting should be self-explanatory. Basically menu and widget appearance can be modified by X resources file. PROGRAM_NAME is the name of the produced executable when program was compiled.

If widget.profile resource is set, widget files are looked from PREFIX/share/detroit/widgets/widget.profile-directory.

Copyright © 2025, Jani Salonen <salojan at goto10 piste co>. Piste is finnish word and means dot. All rights reserved.