#
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_CC
  currently used by Blend Algebra/BlendProgram plugins' C compiler executablewith default of gcc; may be used in the future for other purposes.
CIN_CONFIG
  configuration data; defaults to $HOME/.bcast5.
CIN_DAT
  location of data files, such as documentation, models, tip of the day; also for Blend Algebra/Blend Program plugins' system library with scripts, headers, and functions that are distributed with Cinelerra reside in subdirectory $CIN_DAT/dlfcn.

CIN_EDITOR
  BlendAlgebra/BlendProgram plugins' C text editor with default of emacs; may be used in the future for other purposes.
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_USERLIB
  for use by BlendAlgebra/BlendProgram plugins for user's library, default is $HOME/.bcast5lib). User's functions reside in subdirectory $CIN_USERLIB/dlfcn; may be used in the future for other purposes.
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.