Skip to content
scarletnxPublic

About

A test program that compares a console with its emulators

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

509 Commits

Folders and files

Repository files navigation

Amberlith

Wimsy as Amberlith, in amber with a test probe
Wimsy as Amberlith

A test program for the console and its emulators. Every case works out the answer it expects, checks the one it got, and writes it to a report that can be compared between two machines: a console and an emulator, or two builds of one emulator. No case needs a person to look at the screen.

Quick start

The newest version is on its release, as amberlith-<version>.nro, and the newest nightly on nightly (Releases).

  • On a console: put it in the SD card's switch/ folder and open it from the homebrew menu.
  • In an emulator: open the NRO.
  • On Android, or ScarletNX's Android layer: the APK, android/ (On Android), the same engine with Android's own cases beside the ones every machine runs.

Without a mode file the start screen asks what to run, and its L and R open the browser, where a person runs a suite, a single case or a demo at a time (The browser); sdmc:/amberlith/mode chooses instead (Mode file): quick all runs every family that needs nobody, all but pad, nvn, demo, music and pace. Naming a family runs that family alone. nvn's window case runs only in a quick run from the mode file, never in one begun on the start screen, noprogress or not. The report goes to sdmc:/amberlith/runs/<build>/report.jsonl (Report).

Build

With devkitPro in /opt/devkitpro:

export DEVKITPRO=/opt/devkitpro
make                                  # amberlith.nro
make -f host.mk host-run              # the judge and the tools' tests, on this machine
gradle -p android assembleDebug       # the APK, with ANDROID_HOME and a JDK 17 or newer
make run EMULATOR=/path/to/emulator   # a quick run, started again after a crash

See Build, Running it under an emulator, Running it on Android and Frontends. Every document: docs.

Credits

Amberlith follows switch-examples and builds on libnx and deko3d; what comes from each, and from the other projects it uses, is in Credits. Wimsy, ScarletNX's mascot, was drawn by Liz.

Licence

GPL-3.0-or-later; the full text is in LICENSE.

About

A test program that compares a console with its emulators

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages