Design
This article is a living document that details the design and development process of jabara.
Purpose
jabara is a Nintendo Switch (codename NX) emulator designed to provide robust tool-assisted speedrun and superplay (generally, TAS) functionality for Switch games. Its use case differs from existing NX emulators (e.g. Eden, Ryujinx) in that it is designed primarily for TAS creation and playback with optimized real-time gameplay as a secondary target.
jabara is not a cheating tool and is not intended to give unfair advantages to real-time attack (RTA) speedrunners. jabara is not a tool for piracy or copyright violation and may only be used with legally extracted ("dumped") copies of owned NX software.
Scope
jabara cannot be used to emulate the Nintendo Switch 2.
jabara can be used on x86-64 and AArch64 machines running any modern version of most Linux distributions or Windows. Support for mobile devices is not planned.
jabara aims to provide a wide variety of tools for creating and replaying TASes. Among others, tools offered for TAS developers (TASers) include frame advance, savestates, input manipulation, memory viewing, system state and random number generation (RNG) manipulation, and debugging. All information that constitutes a particular TAS may be recorded to a movie file that can be used to deterministically replay the TAS on any instance of jabara, assuming all necessary game data are present and unchanged.
Support for physical input devices such as controllers or keyboards is an eventual goal to make jabara viable for real-time gameplay.
Setup
To best benefit users and developers, jabara was chosen to be a free and open source software project in order to allow free modification and redistribution and encourage community contribution. jabara is licensed under the GNU GPLv3 and can be used under the terms of any later version of the GPL. Nintendo has a history of issuing DMCA takedown requests to emulation projects,[1] especially to public GitHub repositories, so the decision was made to selfhost the relevant Git repositories on an instance of Forgejo. The public Git forge can be accessed at https://git.zelda.sr.
Due to the high performance required to efficiently emulate NX software and the portability desired of the project, the use of a low-level, compiled programming language to develop jabara was imperative. Rust was chosen for its efficiency, memory safety, portability, and robust feature set. Following initial branding, a basic Rust crate (package) structure was created and the main project repository was set up on git.zelda.sr at jabara/jabara.
This wiki, an instance of MediaWiki, was created during development to organize project design on this article. By release, this wiki will also document emulator features and provide various emulator setup and TASing guides.