---
name: "Audio::Nama::Globals"
section: "3pm"
platform: "linux"
package: "nama"
version: "1.216-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Audio::Nama::Globals"
---

# Audio::Nama::Globals(3pm)

Nama global variables Variables are listed in multiple files in the source.

## NAME

Audio::Nama::Globals - Nama global variables

Variables are listed in multiple files in the source.

### Exported

Audio::Nama::Globals exports Nama globals,  which it gets by merging the contents of the following files:

- *var\_pronouns*

  Pronouns (e.g. `$this_track`) and  indices (e.g. `%tn`, get track by name)

- *var\_serialize*

  Marshalling variables for serializing/deserializing (e.g. `@tracks_data`)

- *var\_singletons*

  Simple hash structures (such as `$config`) or objects such as *$file* that aggregate data.  The hashes can be invested with object properties as need be.

### Other lists

- *var\_config*

  Maps keys in *.namarc* (e.g. *mix\_to\_disk\_format*) to the corresponding Nama internal scalar (e.g. `"$config->{mix_to_disk_format}"`

- *var\_keys*

  List of allowed singleton hash keys.

  Keys of variables appearing in ./var\_singletons  should be listed in var\_keys or in var\_config. Undeclared keys will trigger warnings during build.

### *var\_lists*

Declares lists of variables used in serializing/deserializing.

- @global\_effect\_chain\_vars

  Mainly user defined and system-wide effect chains, stored in *global\_effect\_chains.json* in the  Nama project root directory.

- @tracked\_vars

  These variables are saved to *State.json* in the project directory and placed under version control.

- @persistent\_vars

  These Variables saved to *Aux.json*, *not* under version control. including project-specific effect-chain definitions, and track/version comments.