ASAHI-NVRAM(1)

📦 version 0.2.4, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ASAHI-NVRAM 💖

okay bestie, gather round, because this is the manual page for asahi-nvram — a little tool that reads and writes nvram variables on Apple Silicon Macs. yes, those Macs. the M-chip girlies. she's giving low-level, she's giving firmware-adjacent, and she's literally here to help you peek at and poke your nvram. 🍓

✨ SYNOPSIS ✨

asahi-nvram [OPTIONS] [SUBCOMMAND]

that's it. that's the whole vibe. options first, subcommand after, go wild. 🦋

🌸 OPTIONS 🌸

  • -d, --device <DEVICE> — tell her where the nvram device lives, by path. <DEVICE> is the path to the nvram device. yes you get to point at it yourself, main character energy. 👑
  • -h, --help — print help information. the classic. the icon. when in doubt, hit -h. 💅
  • -V, --version — print version information. so you know exactly which girl you're dealing with. ✨

🎀 SUBCOMMANDS 🎀

  • delete — delete nvram variables. accepts multiple nvram variables as arguments. plural! she's flexible like that. 🗑️
  • help — print top-level help or the help of the given subcommand(s). your emotional support flag fr fr. 🫶
  • read — read nvram variables. accepts multiple nvram variables as arguments. look but don't touch, we love a respectful queen. 👀
  • write — write nvram variables. accepts multiple nvram variable assignments in the form <VAR>=<VALUE> as arguments. so like, NAME=VALUE style, as many as you want in one go. 💖

🧚 NVRAM VARIABLE FORMAT 🧚

so here's the tea on how nvram variables get parsed. they come in the format:

<PARTITION>:<NAME>

where <PARTITION> is one of 'system' or 'common'. that's the whole rule. colon goes between the partition and the name, no cap. 🌈

⚠️ WARNING ⚠️

Writing to nvram may result in having to perform a DFU restore. Avoid unless you know what you're doing.

like, bestie, i need you to HEAR me on this one. 😭 writing to nvram can land you in DFU restore territory. that's the "plug into another Mac and pray" zone. do not go writing things unless you genuinely, truly know what you're doing. this is the one part of the page where i am not being cute. be careful. 💀

that's the whole page, babe. go read your nvram responsibly. 💜

this has been asahi-nvram, from the User Commands corner of your manual, in the April 2025 edition. 🎀✨🦋

📦 where this page comes from