gafrc (Lepton EDA Reference Manual 1.9.18)

#### 3.2.1 `gafrc` ¶

`gafrc` is a configuration file used by various tools in the Lepton EDA suite.

Files named `gafrc` are read from `~/.config/lepton-eda/` (user configuration) and from a directory where you run the lepton-eda tools (configuration for current directory). Expressions in `gafrc` files control the following settings:

- Component and source libraries. Component libraries is a list of directories where Lepton will search for symbol files (`*.sym`). Source libraries is a list of directories where Lepton will search for source files (defined by the source= attribute) used in hierarchical schematics.
  - `(reset-component-library)`

    Clear the list of component libraries.

  - `(reset-source-library)`

    Clear the list of source libraries.

  - `(component-library path name)`

    Add the directory path to the list of component libraries giving it a display name name which will be shown in the "Add Component" dialog in `lepton-schematic`, for example:

        (component-library "/home/dmn/sym" "MySymbols")

  - `(component-library-search path prefix)`

    Add the directory path recursively with all its sub-directories to the list of component libraries. Directories added with this command will be shown in `lepton-schematic` in the "Add Component" dialog prefixed with the string prefix, for example:

        (component-library-search "/home/dmn/my-libs" "MyLibs::")

  - `(source-library path)`

    Add the directory path to the list of source libraries.

- Color scheme used for exporting/printing by `lepton-cli export` and `lepton-schematic`’s ‘`File`’->‘`Write Image...`’ (if "Image type" is set to ‘`PDF`’) and ‘`File`’->‘`Print...`’ main menu commands.
  - `(primitive-load file)`

    Load a color scheme from file file, for example:

        (primitive-load "/usr/share/lepton-eda/print-colormap-darkbg")