MaXXdesktop Variables

This Book describes in great detail the various environment variables used throughout the Desktop.

Environmental Variables

Environmental Variables Supported under MaXXdesktop

Name

Description

Default Value

BITS  2

Defines the CPU bit architecture. It is either 32 or 64. MaXXdesktop currently only ships with 64-bit executables, but 32-bit libraries will be provided in order to compile and/or run 32-bit applications under 64-bit OS.

MAXX_HOME  2

Defines the root directory of MaXXdesktop installation directory.

/opt/MaXX

MAXX_SETTINGS  2

Defines the root directory used by MaXXsettings to store its system wide default values.

$MAXX_HOME/share/msettings

MAXX_BIN 2

Defines the location of MaXXdesktop executables directory.

$MAXX_HOME/bin$BITS

MAXX_LIBS 2

Defines the location of MaXXdesktop specific libraries directory.

$MAXX_HOME/lib$BITS

MAXX_INCLUDES 2

Defines the location of MaXXdesktop header files directory. Used only if you develop MaXXdesktop friendly applications.

$MAXX_HOME/include

MAXX_MOTIF_CLASSIC 2

Defines the location of our own SGI-Motif 2.1 library. This library provides source-code compatibility for SGI applications and simplifies porting from IRIX to Linux Motif applications.

$MAXX_HOME/OpenMotif-2.1.32

MAXX_LOCALES 2

Defines the location of all I10n, internationalization and multi-languages support and resources.

$MAXX_HOME/share/locale

MAXX_LIBRARY_PATH 2

Defines paths to locate all MaXXdesktop libraries. This variable is appended to the user’s shell $LD_LIBRARY_PATH

$MAXX_LIBS:$MAXX_VIEWKIT/lib$BITS
:
$MAXX_MOTIF_CLASSIC/lib$BITS

MAXX_PKG_CONFIG_PATH 2

Defines MaXXdesktop specific PKG_CONFIG location.

$PKG_CONFIG_PATH
:$MAXX_HOME/lib$BITS/pkgconfig

Notes:
1 $MAXX_HOME/etc/skel/Xsession.dt
2 $MAXX_HOME/etc/system.runtime
3 $MAXX_HOME/etc/system.desktopenv
4 $MAXX_BIM/desktopenv

MaXXdesktop Shell Variables

Shell Variables Defines by MaXXdesktop (as of v2.1.1)

Name

Description

Default

LANG3  4 

Defines the language, locale and encoding to use. On some older system or non Unicode friendly environments, this value defaulted to C.

en_US.UTF-8

WM 3

Defines which Window Manager to use in a XSession.

5Dwm

XCURSOR_THEME 3  4 

Defines the XCursor Theme used by the Xorg XServer.

redSGI

WORKSPACE 1

Name of the Desktop workspace name. The workspace defines and stores icon information visible on the Desktop.  This is currently tightly coupled with ROX-Filer file-manager, but we plan to bring over this concept into our own implementation of SGI filemanager, aka fm.

myspace

DESKTOP_STYLE 3  4 

Defines which look and feel the user experience is set to.  CLASSIS is the original SGI look with aliased fonts and MODERN with anti-aliased font rendering and UTF-8 encoding.

This value is linked with MaXX-Settings : Desktop.Style

CLASSIC

SGI_SCHEME 3  4 

Defines the SGI Scheme to use for all Xt and Motif applications. SGI Schemes are located in :  $MAXX_HOME/share/X11/schemes.

Use the schemebr or scheme_selector.sh application to change/select a different Scheme. Alternatively, you can use Toolchest -> Desktop -> Customize -> Color Schemes.


This value is linked to MaXXsettings : Desktop.Colors.SgiScheme

IndigoMagic

SGI_DARK_SCHEME 4

Hint for SGI Scheme text color and contrast management. When a dark Scheme is selected, automatically a brighter/lighter text color is chosen to improve text readability. This value is tightly coupled with the selected SGI Scheme.


This value is linked to MaXXsettings : Desktop.Colors.SgiDarkScheme

False

SGI_DARK_BACKGROUND 4 

Hint for text icons color on the Desktop. When a dark background is selected, automatically a brighter/lighter text icon color is chosen to improve text readability. This value is tightly coupled with the selected Desktop background color or image.


This value is linked to MaXXsettings : Desktop.Background.SgiDarkBackground

False

GTK_THEME 3  4 

Defines the GTK 3+ Theme to use for all GTK based applications. There is a one to one mapping between GTK Theme and SGI Scheme. GTK Themes are located in :  $MAXX_HOME/share/themes.

Use the schemebr or scheme_selector.sh application to change/select a different Scheme. Alternatively, you can use Toolchest -> Desktop -> Customize -> Color Schemes.

IndigoMagic

GTK2_RC_FILES 3  4 

Defines the GTK 2 Theme location to use for all GTK 2 applications. Legacy GTK application.

-

Notes:
1 /opt/MaXX/etc/skel/Xsession.dt
2 /opt/MaXX/etc/system.runtime
3 /opt/MaXX/etc/system.desktopenv
4 $HOME/.maxxdesktop/desktopenv

HiDPI Shell Variables

 

MaXX Desktop HiDPI Shell Variables

Name

Description

Default

MAXX_SCREEN_SCALE_FACTORS 3  

Define a list of screen id with effective scaling factor separated by ‘:’ (like PATH).

For example, the screen 0 had a scale factor of 1.0 and screen 2 a factor of 2.2. Therefor the MAXX_SCALE value would be:  0/1.0:1/2.2

0/1.0

GDK_SCALE 1 2

Defines GTK+3 UI widgets scale factor.  1 means no widget scaling.

1.0

GDK_DPI_SCALE 1 2

Defines GTK+ 3 text scaling factor. 1 means no text scaling.

1.0

QT_AUTO_SCREEN_SCALE_FACTOR 1 2

Controls QT Auto Scaling based on HiDPI. 0 means disabled.

0

QT_SCALE_FACTOR 1 2

QT_SCALE_FACTOR scales fonts,  1 means no text scaling.

1.0

QT_SCREEN_SCALE_FACTORS 1 2

QT_SCREEN_SCALE_FACTORS does not scale fonts. 1 means no text scaling.

1.0

Notes:

1 /opt/MaXX/etc/system.desktopenv
2 $HOME/.maxxdesktop/desktopenv
3 Not defined yet

XDG Environment Variables

MaXX Desktop XDG Environment Variables

Name

Description

Default

XDG_DATA_HOME

Defines the base directory relative to which user specific data files should be stored

$HOME/.local/share

XDG_CONFIG_HOME

Defines the base directory relative to which user specific configuration files should be stored

$HOME/.config

XDG_DATA_DIRS

Defines the preference-ordered set of base directories to search for data files in addition to the $XDG_DATA_HOME base directory. The directories should be separated with a colon ':'

/usr/local/share/:/usr/share/

XDG_CONFIG_DIRS

Defines the preference-ordered set of base directories to search for configuration files in addition to the $XDG_CONFIG_HOME base directory.

/etc/xdg

XDG_CACHE_HOME

Defines the base directory relative to which user specific non-essential data files should be stored.

$HOME/.cache

XDG_RUNTIME_DIR

Defines the base directory relative to which user-specific non-essential runtime files and other file objects (such as sockets, named pipes, ...) should be stored. The directory MUST be owned by the user, and he MUST be the only one having read and write access to it. Its Unix access mode MUST be 0700.

The lifetime of the directory MUST be bound to the user being logged in.

Applications should use this directory for communication and synchronization purposes and should not place larger files in it, since it might reside in runtime memory and cannot necessarily be swapped out to disk.

XDG Reference https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables

Notes on all XDG variables