RGBASM(1) General Commands Manual RGBASM(1) (NAME) rgbasm - Game Boy (SYNOPSIS) rgbasm [-EhVvw] [-B param] [-b chars] [--color when] [-D name[=value]] [-g chars] [-I path] [-M depend_file] [-MG] [-MC] [-MP] [-MT target_file] [-MQ target_file] [-o out_file] [-P include_file] [-p pad_value] [-Q fix_precision] [-r recursion_depth] [-s features:state_file] [-W warning] [-X max_errors] asmfile (DESCRIPTION) rgbasm RGB . rgbds(5) . (ARGUMENTS) rgbasm -V --version . . : --verb --verbose --ver --version . `-' ( ) rgbasm ( ) ( ) . `-' `./-' . . rgbasm () () () . `$' `0x' `&' `0o' `%' `0b' . ( `$' `&' .) ( ) . : `42', `042', `0x2A', `0X2A', `0x2a', `&52', `0o52', `0O052', `0b00101010', `0B101010'. : -B param, --backtrace param (backtraces) . . param . : 0 . all <<>> ( "Excluding locations from backtraces" rgbasm(5) ). no-all << >> . collapse . no-collapse . -b chars, --binary-digits chars `0' `1' . `0' `1 ' `. ' `#' `@' . --color when : `always ' `never' `auto'. `auto' `NO_COLOR: https://no-color.org' `FORCE_COLOR: https://force-color.org' TTY . -D name[=value], --define name[=value] . `name EQUS "value"' `name EQUS "1"' value . -E, --export-all . -g chars, --gfx-chars chars `0 ' `1 ' `2' `3' . `0' `3 ' `. ' `#' `@' . 0123 . -h, --help . ( COLUMNS TTY .) -I path, --include path " (include path)" path . INCLUDE ( -P -) INCBIN READFILE rgbasm "include path" . -M depend_file, --dependfile depend_file make(1) depend_file . -MG -M . rgbasm : INCLUDE ( -P -) INCBIN READFILE rgbasm ( -MC ). Makefile . -MC -MG . rgbasm . IF. -MP (phony target) -M . make(1) . -MT target_file -M . . -MT fileA -MT fileB -MT 'fileA fileB' . -MQ . -MQ target_file -MT - make(1) ( `$') . -o out_file, --output out_file . -P include_file, --preinclude include_file . `INCLUDE "include_file"' asmfile . . -p pad_value, --pad-value pad_value DS ROM . 0x00 . -Q fix_precision, --q-precision fix_precision - . - Q16.16 ( ). `.' Q : `-Q .16'. -r recursion_depth, --recursion-depth recursion_depth rgbasm . 64 . -s features:state_file, --state features:state_file rgbasm state_file . : equ `def name equ value' . var `def name = value' . equs `def name equs "value"' . char `charmap name, value' . macro `macro name ... endm' . all equ,var,equs,char,macro . ( (EXAMPLES) ). -V, --version . -v, --verbose . : 1. rgbasm . 2. . 3. . 4. . 5. . . RGBDS . -W warning, --warning warning warning . warning . (DIAGNOSTICS) . -w . -X max_errors, --max-errors max_errors ( ) -X 0 . rgbasm . @at_file . . (`#') . . . `--' at-file . `--' at-file at-file . (DIAGNOSTICS) . : -Werror . -Wno-error . -Werror= (meta warning) . ( : -Werror=obsolete -) . -Wno-error= -Werror - . "meta" . meta . . -Wall . -Wextra . -Weverything . . ( -Wobsolete -Wno-obsolete -Wall -Wno-all ). . "no- " . -Wno-assert WARN. ( ASSERT "Aborting the assembly process" rgbasm(5) ). -Wbackwards-for FOR . -Wall . -Wbuiltin-args STRSLICE() . -Wall . -Wcharmap-redef charmap. -Wall . -Wdiv (2**31-) 1- . -Wempty-data-directive DB DW DL ROM . -Wall . -Wempty-macro-arg . -Wextra . -Wempty-strrpl STRRPL() ( ) . -Wall . -Wexport-undefined . -Wall . -Wno-large-constant . -Wmacro-shift . -Wextra . -Wno-nested-comment `/*' . `*/' . -Wno-obsolete . -Wnumeric-string= . -Wnumeric-string=0 -Wno-numeric-string . -Wnumeric-string=1 -Wnumeric-string . -Wnumeric-string=2 . -Wpurge= . -Wpurge=0 -Wno-purge . -Wpurge=1 ( ) . -Wpurge=2 -Wpurge ( ) . -Wshift . 2**N . -Wshift-amount . -Wtruncation= ( db ) . -Wtruncation=0 -Wno-truncation . -Wtruncation=1 -Wtruncation N 2**N 2**N- . -Wtruncation=2 N (1-2**N)- . -Wunmapped-char= charmap . -Wunmapped-char=0 -Wno-unmapped-char . -Wunmapped-char=1 -Wunmapped-char charmap . -Wunmapped-char=2 charmap / charmap `main' . -Wunmatched-directive PUSHC PUSHO PUSHS POPC POPO POPS . -Wextra . -Wunterminated-load LOAD ENDL . -Wextra . -Wno-user WARN . ( WARN "Aborting the assembly process" rgbasm(5) ). (EXAMPLES) . : $ rgbasm -o bar.o foo.asm (pipes): $ cat foo.asm | rgbasm -o bar.o - $ rgbasm -o bar.o - < foo.asm ROM -- rgblink(1) rgbfix(1) . : $ rgbasm -s all:state.dump.asm foo.asm : $ rgbasm -s equ,var:numbers.dump.asm -s equs:strings.dump.asm foo.asm (BUGS) GitHub: https://github.com/gbdev/rgbds/issues . (SEE ALSO) rgbasm(5), rgblink(1), rgbfix(1), rgbgfx(1), gbz80(7), rgbasm-old(5), rgbds(5), rgbds(7) (HISTORY) rgbasm Carsten Sorensen ASMotor Justin Lloyd RGBDS . https://github.com/gbdev/rgbds . Linux 6.12.107+deb13-amd64 August 1, 2026 Linux 6.12.107+deb13-amd64