VOLTRON(1)

okay so bestie, welcome to voltron(1) β€” yes that's the section 1 manual page, she's a whole vibe, and you're about to understand her πŸ’…βœ¨ grab a strawberry, we're doing this πŸ“

🌸 NAME 🌸

voltron β€” hacky debugger UI for hackers πŸ˜ŒπŸ’… no notes, that's literally the tagline


πŸ¦‹ SYNOPSIS πŸ¦‹

okay so here's every single way you can summon her, verbatim, don't @ me:

voltron [-h]

voltron [--debug] [-o O] [(view|v) <view name>]

voltron [--debug] [-o O] (view|v) (memory|m|mem) [-h] [--show-header]
[--hide-header] [--show-footer] [--hide-footer] [--name NAME] [--deref |
--bytes BYTES] [--reverse] (--address ADDRESS|--command
COMMAND|--register REGISTER)

voltron [--debug] [-o O] (view|v) (command|c|cmd) [-h] [--show-header]
[--hide-header] [--show-footer] [--hide-footer] [--name NAME] [--lexer
LEXER] command

like, pick your fighter 🫢


πŸ’œ DESCRIPTION πŸ’œ

so Voltron is an extensible debugger UI toolkit written in Python 🐍. Its whole thing β€” its main character energy, if you will β€” is making the user experience of various debuggers LLDB, GDB, VDB and WinDbg actually good, by enabling the attachment of utility views that can retrieve and display data from the debugger host. and then?? by running these views in other TTYs, you can build a customised debugger user interface to suit your needs πŸ‘‘ like it's giving your debugger, your rules, periodt.


πŸŽ€ getting her set up (the init script moment)

if your debugger has an init script β€” that's .lldbinit for LLDB or .gdbinit for GDB β€” configure it to load Voltron when it starts by sourcing the /usr/lib/python3/dist-packages/voltron/entry.py entry point script. that's it, that's the whole trick, no cap ✨

🌈 LLDB

command script import /usr/lib/python3/dist-packages/voltron/entry.py

🌈 GDB

source /usr/lib/python3/dist-packages/voltron/entry.py
voltron init
set disassembly-flavor intel

look at her go 😭 so iconic


✨ OPTIONS ✨

the following are valid view name in voltron, and honestly? every single one of them ate πŸ”₯

  • backtrace, t, bt, back β€” backtrace view 🫢
  • register, r, reg β€” register values πŸ’œ
  • breakpoints, b, bp, break β€” breakpoints view πŸŽ€
  • command, c, cmd β€” run a command each time the debugger host stops ⭐
  • memory, m, mem β€” display a chunk of memory 🧚
  • disasm, d, dis β€” disassembly view πŸ’…
  • stack, s, st β€” display a chunk of stack memory 🌸

like, seven whole views?? the range. we love a multi-talented queen πŸ‘‘


πŸ‘‘ AUTHOR πŸ‘‘

this manual page was written by ChangZhuo Chen <czchen@debian.org> for the Debian GNU/Linux system β€” but may be used by others, bestie, it's generous like that 🫢


and that's the whole page, fr fr πŸ¦‹ it's VOLTRON(1), dated 10/05/2025, and she understood the assignment. go build your little debugger interface, i'm obsessed, mwah πŸ’–

πŸ“¦ where this page comes from