ZVM-SETTINGS(1)

👑 ZVM-SETTINGS(1) — the manual page, but make it cute 🎀

okay bestie, welcome to zvm-settings(1) from the ZVM User Commands collection ✨ this is the lil page that teaches you how to look at, poke at, and vibe-check ZVM's very own settings.json — and honestly? it's giving main character energy 💅

---

💖 NAME 💖

zvm-settings — view, edit, and check ZVM's settings.json, no cap 🌸

---

✨ SYNOPSIS ✨

zvm settings
zvm settings .key [value]
zvm settings --check

---

🦋 DESCRIPTION 🦋

So here's the tea, bestie 🍓 — when you run it with no arguments inside a terminal, it opens up an interactive editor for settings.json. Iconic. But the moment standard input or standard output is not a terminal, it doesn't open the editor — instead it prints the settings as JSON. Lowkey considerate, fr fr 💜

A .key argument picks out exactly one setting, and it uses jq dot notation to do it — so all three of these are valid: .useColor, ."useColor", or .["useColor"]. And the path . selects the whole file (yes, the entire thing, go off 👑).

Quick reminder though: settings.json is a flat object, so nested paths get rejected. That's just the rules 💅

• With only a key, it prints that key's value as JSON.
• With a key and a value, it validates the value and saves it.

Now for the validation deets, because this part matters 🔥:

• Booleans take true or false.
• Strings may be given bare or as a quoted JSON string.
• URLs must use HTTP or HTTPS.
• mirrorListUrl also accepts disabled (special lil guy 🧚).
• minisignPubKey must be a valid minisign public key.

⚠️ If a value is invalid, it gets rejected and nothing is saved. No silent mess, no corrupt file — she simply refuses 😌

And when settings.json is loaded, any invalid entries — malformed JSON, wrong types, invalid values, or unknown keys — get reported as warnings, and ZVM just uses the defaults for them without rewriting the file. The editor marks those entries so you can see them 👀; saving replaces them with valid values and drops unknown keys. Clean slate behavior, periodt ✨

---

🎀 EDITOR KEYS 🎀

moving around 🕺

• j, k, Down, Up — move between settings. classic.
• g, G, Home, End — jump straight to the first or last setting. zoom zoom 🦋

editing 💅

• Enter, i, l — edit the selected value. Enter applies it, Esc cancels. no commitment issues here 🫶
• Space — toggle a boolean setting. flip it like a light switch 💡
• r — reset the selected setting back to its default. we love a fresh start 🌸

saving 💾

• w, Ctrl+S — save settings.json. protect your work bestie 😭

vim girlies rise 👑

• :w, :q, :wq, :x, :q! — vim-style save and quit commands. iykyk 🔥

leaving 🚪

• q, Esc — quit. buuut if you've got unsaved changes, you gotta press q again to quit without saving. she's just checking you're sure 🙈

---

⭐ OPTIONS ⭐

• --check — reports every invalid entry in settings.json, and exits with a non-zero status if there are any. the ultimate vibe check 🔍
• -r, --raw-output — prints string values without JSON quotes, exactly like jq -r. clean output, no extra fluff 💜

---

🌈 EXAMPLES 🌈

zvm settings .useColor
zvm settings .useColor false
zvm settings -r .mirrorListUrl
zvm settings .mirrorListUrl disabled
zvm settings --check

look at her go 😭✨ all five, slaying in their own little way.

---

🫶 SEE ALSO 🫶

• zvm(1)
• zvm-mirrorlist(1)
• zvm-vmu(1)

go read those too, they're literally part of the family 💖

---

ZVM v0.9.4 · October 2026 — that's the version and the date, bestie 🎀 and that's a wrap on zvm-settings(1)! now go forth and edit your settings with confidence, you gorgeous nerd 👑💅✨