pxl8/README.md

pxl8

Quick Start

./pxl8.sh build                                 # Build pxl8 system
./pxl8.sh install                               # Install pxl8 binary to ~/.local/bin
./pxl8.sh run [game.cart | project_dir]         # Run pxl8 demo (or a specific game)
./pxl8.sh run [game.cart | project_dir] --repl  # Run pxl8 demo (or a specific game) with a REPL

Requirements

• Clang 19+ (or GCC 15+) - Required for C23 #embed support
• Rust nightly (edition 2024) - Required for pxl8d server
• SDL3 - System package or auto-vendored

License

pxl8 is free and open source. All code in this repository is licensed under:

• Mozilla Public License, Version 2.0 (LICENSE or https://mozilla.org/MPL/2.0/)

Third-party dependencies (Fennel, linenoise, LuaJIT, miniz, SDL3) retain their original licenses.

@@@@@@@@@@@@@@@@@@@@@**^^""~~~"^@@^*@*@@**@@@@@@@@@
@@@@@@@@@@@@@*^^'"~   , - ' '; ,@@b. '  -e@@@@@@@@@
@@@@@@@@*^"~      . '     . ' ,@@@@(  e@*@@@@@@@@@@
@@@@@^~         .       .   ' @@@@@@, ~^@@@@@@@@@@@
@@@~ ,e**@@*e,  ,e**e, .    ' '@@@@@@e,  "*@@@@@'^@
@',e@@@@@@@@@@ e@@@@@@       ' '*@@@@@@    @@@'   0
@@@@@@@@@@@@@@@@@@@@@',e,     ;  ~^*^'    ;^~   ' 0
@@@@@@@@@@@@@@@^""^@@e@@@   .'           ,'   .'  @
@@@@@@@@@@@@@@'    '@@@@@ '         ,  ,e'  .    ;@
@@@@@@@@@@@@@' ,&&,  ^@*'     ,  .  i^"@e, ,e@e  @@
@@@@@@@@@@@@' ,@@@@,          ;  ,& !,,@@@e@@@@ e@@
@@@@@,~*@@*' ,@@@@@@e,   ',   e^~^@,   ~'@@@@@@,@@@
@@@@@@, ~" ,e@@@@@@@@@*e*@*  ,@e  @@""@e,,@@@@@@@@@
@@@@@@@@ee@@@@@@@@@@@@@@@" ,e@' ,e@' e@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@" ,@" ,e@@e,,@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@~ ,@@@,,0@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@,,@@@@@@@@@@@@@@@@@@@@@@@@@