GNWManager is THE game-and-watch device manager. GNWManager is responsible for getting firmware onto your device, managing the filesystem, and other device administrative tasks.

Features

Standalone and simple to install.
- No more installing many different tools with various patches!
Fast internal and external flash firmware flashing.
- Only syncs changed data.
- Minimizes flash erases and writes, extending flash lifespan.
- Double buffered, asynchronous transfers for maximum speed.
Complete filesystem management.
- Backup and restore files.
- Interactive filesystem explorer.
Automatic Real-Time-Clock (RTC) configuration.
Developer tools:
- Easily monitor device printf statements and launch GDB sessions.
- Capture screenshots, regardless of the running firmware.

Installation

It is highly recommended to use pipx to install GnWManager:

pipx install gnwmanager

That's it!

Usage

To see available commands, run gnwmanager --help.

$ gnwmanager --help

 Usage: gnwmanager [OPTIONS] COMMAND [ARGS]...

╭─ Options ─────────────────────────────────────────────────────────────────────────────╮
│ --version  -v        Print gnwmanager version.                                        │
│ --help               Show this message and exit.                                      │
╰───────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────╮
│ debug             GnWManager internal debugging tools                                 │
│ disable-debug     Disables the microcontroller's debug block.                         │
│ erase             Erase a section of flash.                                           │
│ flash             Flash firmware to device.                                           │
│ format            Create a directory on device.                                       │
│ gdb               Launch a gdbserver and connect to it with gdb.                      │
│ gdbserver         Spawn a gdbserver.                                                  │
│ ls                List contents of device directory.                                  │
│ mkdir             Create a directory on device.                                       │
│ monitor           Monitor the device's stdout logging buffer.                         │
│ mv                Create a directory on device.                                       │
│ pull              Pull a file or folder from device.                                  │
│ push              Push file(s) and folder(s) to device.                               │
│ screenshot        Pull and decode a screenshot from device.                           │
│ shell             Launch an interactive shell to browse device filesystem.            │
│ start             Start firmware at location.                                         │
╰───────────────────────────────────────────────────────────────────────────────────────╯