// reference
Tools & CLI
Every script and helper that ships with the project.
The visor command
Installed to /usr/local/bin by the installer — the host-side Swiss
army knife:
| Command | What it does |
|---|---|
visor build | Runs make in the source checkout (extra args pass through). |
visor install | Runs install.sh (args pass through). |
visor update | Clones/pulls the latest source, rebuilds, reinstalls — never touches your boot.conf. Flags: --esp, --repo, --branch, --source-dir, --boot-entry, --sign, --force-config. |
visor encrypt <kernel> [initrd] | One-password encryption of kernel+initrd, installs to the ESP, generates the boot entry (with LUKS auto-detection) and offers to append it to boot.conf. See Encryption. |
visor sign | Signs the installed EFI binaries with sbctl (--no-drivers to skip drivers). |
visor drivers | Detects the /boot filesystem and installs the matching EfiFs driver (--fs TYPE, --sign). |
visor status | Reports install state: binary, config, drivers, encrypted artifacts (validates VISORENC headers). |
visor config validate | Syntax-checks a boot.conf before you reboot into it. |
visor doctor | Checks build/install dependencies. |
visor uninstall / visor clean | Removes the ESP install + boot entry / removes build outputs. |
Root scripts
| Script | Purpose |
|---|---|
get.sh | The curl | sh bootstrapper: installs distro build deps, clones to ~/.cache/visor-src, builds, and runs the installer (via bash, so it works even when exec bits were lost in transit). |
install.sh | The installer proper: ESP detection, file copies, boot entry, signing, drivers, CLI install. All flags in Install & Run. |
Makefile | Dual-arch build — see Building. |
tools/
| Tool | Purpose |
|---|---|
visor_encrypt.py | Creates VISORENC v2 containers. Takes any number of INPUT OUTPUT pairs under one password prompt; --iterations N tunes PBKDF2. Pure-stdlib Python (its ChaCha20 is self-contained). |
visor-snapshot-sync | Run on the host (e.g. from a pacman/apt hook): scans snapper/Timeshift/plain btrfs snapshots and writes \EFI\visor\snapshots.conf with exact per-snapshot kernels, initrds, and cmdlines. Visor also reads \EFI\visor\snapshot.conf (singular) as a fallback. |
bake_font.py | Renders a TTF into src/font_jetbrains.c glyph bitmaps (Python + Pillow). Driven by make bakefont FONT=... FONT_PX=.... |
setup_gnuefi_aarch64.sh | One-time cross-build of gnu-efi for the AArch64 target. |