sl0pboy.git/README.md, branch master

docs: document the SL0PBOY boot-logo patcher (tools/mk_sl0pboy_bios.py)

2026-07-18T20:47:08Z

Add a BIOS subsection covering usage (Pillow dep, SL0P_TEXT/SL0P_FONT knobs, the preview PNG), how the in-place $0607 blob patch works, and why the forked binary stays out of git while the generator ships.

hooks: clang-format pre-commit (changed lines only) + .clang-format

2026-07-18T18:57:37Z

git-clang-format scopes formatting to the lines each commit touches - a full-file reformat would destroy the deliberately dense hand formatting (opcode tables, multi-statement helpers). The hook re-adds formatted files (git-clang-format --staged fixes the worktree, not the index) and refuses partially-staged C files rather than mixing staged and unstaged changes. Enable once: git config core.hooksPath hooks

README: fix source paths in Architecture table (src/ prefix)

2026-07-18T18:53:17Z

The Architecture table listed the core sources as bare filenames (types.h, cart.c, ...), but they live under src/. Prefix them with src/ so the paths actually point at the files.

readme: mention sixel in the intro, drop the diffing brag

2026-07-16T23:12:27Z

readme: trim the fluff, loosen the tone

2026-07-16T23:11:07Z

rebrand: gbc -> sl0pboy (binary, README, tooling)

2026-07-16T23:08:48Z

main: options-first CLI with --help, and wire up display/boot flags

2026-07-16T22:27:46Z

- Rewrite argument handling: the ROM is now the final argument and options precede it (parsed in argv[1..argc-2] so optional-value flags never swallow the ROM). Add grouped --help/-h, unknown-option errors, and clear 'missing value'/'no ROM' diagnostics. - Add --chrome, --palette/--green, and --bios flags; set the display/capture options before the --shot and recording paths so screenshots and recordings honor them. Make --shot dump the composited capture frame. - gbctl: pass the ROM last when spawning the emulator. - gitignore the (copyrighted) bios/ directory; document all new flags.

serial: headless mode tying serial port to stdio for OS debugging

2026-07-15T21:44:28Z

- --headless: no rendering/TUI; serial TX -> stdout, RX <- stdin (nonblocking) - generalize serial: serial_out_fd/serial_in_fd on the GB; internal-clock transfer now shifts in a real RX byte (from stdin) instead of always 0xFF - paced to native speed by default, --uncapped for turbo; pipes/scripts cleanly - README: document headless serial console

control: video frame capture + deterministic input-movie replay

2026-07-15T14:53:28Z

Two socket features for building reproducible showcase clips: - record start [everyN] / record stop: append the RGB888 framebuffer of each produced frame to a flat 'GBCV' capture file (downsample with everyN). tools/gbgif.py turns it into a GIF (or PNG frames). Capture is decoupled from wall-clock/turbo/frameskip, so timing is always correct. - input play [reset] / input stop: drive the joypad from a synthesized TAS-style movie (text: ' [buttons...]' per line), frame-locked so replay is deterministic. 'reset' does an exact power-on (preserve cart ROM+SRAM, zero all other state) so a movie replays byte-identically -- verified by hashing two runs. tools/gbmovie.py is a Python builder for movies.

control: socket-based debug channel + gbctl CLI driver

2026-07-14T21:26:49Z

Replace the input-only FIFO's limitations with a Unix-domain socket control channel (--sock) that is a superset of the button vocabulary plus emulator introspection: read/write bus memory, get/set CPU context, single-step, PC breakpoints, value-change watchpoints, run/pause. Being a socket it replies to each command and broadcasts async 'event stop ...' lines; a stored last-stop record (stopinfo) lets per-request clients recover a missed event. Add gbctl: a stdlib-python CLI that spawns a tmux pane running the emulator on a ROM, auto-resolves the socket, and drives it with terse verbs (cpu/read/write/ reg/step/break/watch/continue/pause/press/hold/screen/stop). The FIFO stays as legacy input-only.