Audio:...lobals(3pm)

✨ NAME ✨

Audio::Nama::Globals — Nama global variables, bestie 💖

(you'll also see the manual page referred to as Audio::Nama::Globals(3pm), that's just the section 3pm library-page thing, iykyk 🎀)

okay so the tea on this one: the variables are listed in multiple files in the source. it's giving "we're not putting all of them in one place, go look" 💅

---

🦋 Exported 🦋

Audio::Nama::Globals exports the Nama globals, and the way it gets them is by merging the contents of the following files. yeah. a whole little friend group of files coming together 🫶

• var_pronouns — pronouns (e.g. $this_track) and indices (e.g. %tn, which is get track by name). so like, the names you call things by ✨
• var_serialize — the marshalling variables for serializing/deserializing (e.g. @tracks_data). packing things up and unpacking them, we love a round trip 📦
• var_singletons — simple hash structures (such as $config) or objects such as $file that aggregate data. and the hashes can be invested with object properties as need be. slay 💅

---

🎀 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}". it's a whole translation service 🌸
• var_keys — the list of allowed singleton hash keys.

keys of variables appearing in ./var_singletons should be listed in var_keys or in var_config. and bestie, undeclared keys will trigger warnings during build — so like, don't leave your keys out in the cold 😭

---

👑 var_lists 👑

declares lists of variables used in serializing/deserializing. the receipts get kept 📝

• @global_effect_chain_vars — mainly user defined and system-wide effect chains, stored in global_effect_chains.json in the Nama project root directory. main character effects, honestly 🔥
• @tracked_vars — these variables are saved to State.json in the project directory and placed under version control. they're in git, they're committed, they're iconic 👑
• @persistent_vars — these Variables saved to Aux.json, not under version control. including project-specific effect-chain definitions, and track/version comments. no git for these ones, they're just vibing offline 🙈

---

lowkey reminder: every option, key and file name up there is exact, so copy them character for character, fr fr 💜

that's the whole page, gorgeous 🧚 this came out ofperl v5.40.1, dated 2026-05-06, and that's the vibe check passed — go run your build and don't let a single undeclared key catch you slipping 🍓 bye bestie!! 💖