Environment Variables for Customization

Environment variables are global variables in the shell which all applications can read. They are set with a command like set VARIABLE=value or export VARIABLE=value. Environment variables can be viewed with a command like env. The values set can be removed with unset VARIABLE.

The following exported variables can be set to customize your environment.
The CIN_CONFIG variable could be extremely useful for testing purposes or for multiple users sharing the same home directory who would like different default preference settings.

CIN_BROWSER

name of browser to use by Shell Cmds options

CIN_CONFIG

configuration data; defaults to $HOME/.bcast5

CIN_DAT

location of data files, such as documentation, models, tip of the day

CIN_LADSPA

LADSPA directory path; use colons to separate multiple paths; this is convenient to define an alternate directory if you share the same executable directory among computers via NFS.

CIN_LIB

location of library programs, such as bdwrite

CIN_LOCALE

locale text domain path to use for translating text

CIN_PLUGIN

plugin directory path

CIN_RENDER

complete filename with path, that was used for select file to render to in the current session’s last successful Render job; this is used in the RenderMux defined Shell Cmds and is available for any user-defined script inside CINELERRA-GG

CIN_PKG

used to set your text domain, that is the locale path pointing to the cin.mo language file

CIN_XSYNCH

(for Developers only) set to 1 helps debugging for windows primitives to execute immediately and not be buffered up so you can see what is happening

One example:

export CIN_BROWSER=chrome       #would override default firefox for Shell Cmds.

Another example:

export CIN_CONFIG=/tmp/.bcast5   #use a temporary setup for testing purposes.

BC_USE_COMMERCIALS=1

to activate the commercial database (db) methods.

BC_TRAP_LV2_SEGV

to get a dump of the failure of an LV2 plugin for help in debugging.

BC_FONT_SCALE=1.2

for changing the default size of the characters to be twice as big.

BC_ICON_SCALE=1.1

for changing the default size of the icons to be bigger; can change # to any. You can increase the size of the characters in the fonts and icons on your CINELERRA-GG system. This will make it easier to read the characters if you have trouble seeing the default small letters, which have been auto-scaled based on the window geometry. The user-friendly font/icon scaling default is 1 but you can set it to any decimal value. To defeat default auto scaling and get any size characters/fonts, override the setting via the previous 2 listed shell environment variables. This is very sensitive, meaning that even a small increase in the numeric value can vary the size quite dramatically.

BC_FONT_PATH=<colon-separated-search-path-for-fonts>

to add additional font sets for the Title plugin or to remove all fonts set to : (colon). An example: export BC_FONT_PATH=/usr/share/fonts.

BC_FONT_DEBUG=1

debug for determining which font is causing problems. 0 for no debug.

BC_SCALE=1.2

for setting up scaling for your monitor where you would like the text and icons to be bigger where 1.2 is a # chosen accordingly; in this case the text and fonts will be 1.2 times the normal size of 1. Refer to the previous Appearance section, Layout Scale for more details.

LADSPA_PATH

specify an alternate set of ladspa plugins or include the default with the use of a colon separated list of directories to search for LADSPA plugins. This is always used first and if it does not exist, then the value for CIN_LADSPA becomes LADSPA_PATH.

LV2_PATH

specify a certain set of LV2 plugins to use. Separate multiple paths with colons.

LANG

CINELERRA-GG can be localized to display menus and messages in many languages. Currently there are 16 languages in addition to English, of varying quality. Some information on these is in the Translations chapter. Language settings are normally read from your Linux O/S locale settings. The CINELERRA-GG program checks environment variables to determine your settings to use as the language. First it checks the value of LANGUAGE and will use that if set. If that is not set, then it checks LC_ALL and finally if that is not set either, it will use the value of LANG. You can check the current settings from a window by looking at the output of the printenv command.

To run on a language different than the one selected on your system just change the LANG environment variable before starting up CINELERRA-GG like this:

export LANG=2 letter language code_2 letter country code.UTF-8

For example, from a window type:

export LANG=es_ES.UTF-8

then startup CINELERRA-GG and you will have translations in Spanish. If you started CINELERRA-GG from that same window using {cinelerra_path}/bin/cin you will see a message in that window something similar to:

lang changed from en_US.UTF-8 to es_ES-UTF-8

However, although generally LANGUAGE is not set, it is possible that another progam that was run may have set it so you may have to substitute LANGUAGE for the word LANG above.

Depending on your Operating System and Desktop application, there may be other ways to accomplish a language change. For example, on Fedora with the Gnome desktop, the simplest method of switching your language to German and immediately starting CINELERRA-GG is to use:

LANGUAGE=de {cinelerra_path}/bin/cin

SHUTTLE_CONFIG_FILE

alternate shuttle configuration file.