# d0k3/godmode9

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/d0k3-godmode9).**

2,554 stars · 218 forks · C · GPL-3.0

## Links

- GitHub: https://github.com/d0k3/GodMode9
- awesome-repositories: https://awesome-repositories.com/repository/d0k3-godmode9.md

## Topics

`3ds` `a9lh` `cia` `file-explorer` `god-mode` `nand` `ncch` `sd-card` `sysnand`

## Description

GodMode9 is a system-level utility for Nintendo 3DS hardware designed for booting unsigned firmware, managing files, and modifying internal memory. It serves as a custom firmware tool for booting specialized payloads and unlocking restricted system features and hardware capabilities.

The project provides a low-level hardware interface for interacting with I2C registers, extracting system keys, and managing raw memory partitions. It functions as a game image dump tool to extract retail cartridges and system images, while also acting as a binary patching utility to alter software behavior via raw hex editing.

The software covers broad capability areas including filesystem administration, system NAND restoration, and game title management. It includes tools for decrypting system images, verifying file integrity through checksums, and automating tasks via custom scripts.

The interface supports hardware button detection, user input dialogs, and visual content rendering on the device screens.

## Tags

### Mobile Development

- [Console Firmware Customizers](https://awesome-repositories.com/f/mobile-development/mobile-operating-systems/firmware-customization-tools/custom-firmware-integration-systems/custom-hardware-firmware/console-firmware-customizers.md) — Installs custom firmware and boots specialized payloads to unlock restricted system features and hardware capabilities.

### Operating Systems & Systems Programming

- [Custom Firmware Tools](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-firmware-tools.md) — Functions as a comprehensive system-level utility for custom firmware management and hardware customization.
- [Firmware Boot Interfaces](https://awesome-repositories.com/f/operating-systems-systems-programming/firmware-boot-interfaces.md) — Launches bootable firmware files directly from the filesystem to initiate system boot. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [Game Cartridge Dumpers](https://awesome-repositories.com/f/operating-systems-systems-programming/game-cartridge-dumpers.md) — Extracts images and private headers from retail cartridges to external storage for backup. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [Game Title Package Managers](https://awesome-repositories.com/f/operating-systems-systems-programming/game-title-package-managers.md) — Encrypts, decrypts, or builds game titles into a standard installable format. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [NAND Partition Management](https://awesome-repositories.com/f/operating-systems-systems-programming/nand-partition-management.md) — Provides tools for backing up and restoring memory partitions and managing virtual NAND instances for system recovery.
- [Raw File Data Manipulators](https://awesome-repositories.com/f/operating-systems-systems-programming/raw-file-data-manipulators.md) — Provides the ability to read, write, and truncate files at specific offsets for raw binary modification. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [File System Operations](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/file-system-management/file-system-operations.md) — Provides standard file system operations for managing system partitions and external storage on the device.
- [Firmware Checksum Verifications](https://awesome-repositories.com/f/operating-systems-systems-programming/firmware-checksum-verifications.md) — Validates firmware file integrity using cryptographic hashes to prevent runtime errors and detect corruption.
- [Hexadecimal Editors](https://awesome-repositories.com/f/operating-systems-systems-programming/hexadecimal-editors.md) — Provides a hex editor to view and modify raw byte data of any file on the system. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [Raw Binary Offset Manipulators](https://awesome-repositories.com/f/operating-systems-systems-programming/raw-binary-offset-manipulators.md) — Modifies files by reading and writing raw bytes at specific memory addresses to alter internal data structures.
- [Storage Media Formatters](https://awesome-repositories.com/f/operating-systems-systems-programming/storage-media-formatters.md) — Allows formatting of external storage and the setup of specialized system partitions. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))

### Data & Databases

- [Virtual NAND Mappers](https://awesome-repositories.com/f/data-databases/indexing-and-search/recall-optimization/conversation-memory-retrieval/memory-unit-denoisers/virtual-memory-card-mapping/virtual-nand-mappers.md) — Simulates system memory by switching between virtual memory instances and refreshing device identification.
- [Virtual Storage Managers](https://awesome-repositories.com/f/data-databases/storage-management-systems/virtual-storage-managers.md) — Switches between available virtual memory instances and refreshes device identification information. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))

### Development Tools & Productivity

- [Filesystem Directory Operations](https://awesome-repositories.com/f/development-tools-productivity/directory-management/administrative-directory-managers/filesystem-directory-operations.md) — Performs low-level filesystem directory operations including moving, copying, and deleting folders. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [System Deployment Package Builders](https://awesome-repositories.com/f/development-tools-productivity/installer-packages/system-deployment-package-builders.md) — Converts images and content data into installable package files for system deployment. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [Task Automation Scripts](https://awesome-repositories.com/f/development-tools-productivity/task-automation-scripts.md) — Executes custom external scripts to automate complex file and system operations.
- [Sequential Payload Chainloading](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/automation-execution-frameworks/automated-payload-execution/sequential-payload-chainloading.md) — Executes firmware files from storage to boot other software payloads sequentially. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [Dynamic Scripting Extensions](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/system-integration-interfaces/automation-apis/scripting-apis/custom-logic-extensions/javascript-logic-extensions/dynamic-scripting-extensions.md) — Allows the execution of external scripts at launch or runtime to extend core system functionality. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))

### Game Development

- [Cartridge Image Dumping](https://awesome-repositories.com/f/game-development/game-asset-extraction/cartridge-image-dumping.md) — Extracts retail cartridges and private headers to external storage for digital backups.
- [Game Code Compression Utilities](https://awesome-repositories.com/f/game-development/game-logic-modification/game-code-compression-utilities.md) — Extracts, decompresses, and compresses code files associated with system titles. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))

### Hardware & IoT

- [I2C Device Interactions](https://awesome-repositories.com/f/hardware-iot/hardware-interaction-toolkits/i2c-device-interactions.md) — Provides direct interaction with I2C peripherals for reading and writing hardware device registers. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [Low-Level Protocol Control](https://awesome-repositories.com/f/hardware-iot/low-level-protocol-control.md) — Enables direct interaction with low-level hardware buses and I2C registers to modify system behavior.
- [Image Mounting](https://awesome-repositories.com/f/hardware-iot/firmware-management/firmware-image-extractors/image-mounting.md) — Opens binary dumps and images as virtual drives for exploration of their internal contents. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))

### Security & Cryptography

- [Firmware Image Decryption](https://awesome-repositories.com/f/security-cryptography/firmware-image-decryption.md) — Decrypts system images and extracts secret keys from memory to analyze protected firmware files. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [Private Key Extractions](https://awesome-repositories.com/f/security-cryptography/private-key-extractions.md) — Extracts title keys and seeds directly from system memory to external storage. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))
- [System Image Decryptions](https://awesome-repositories.com/f/security-cryptography/system-image-decryptions.md) — Decrypts system images and game titles using a database of extracted hardware keys and seeds.

### System Administration & Monitoring

- [Retail Cartridge Dumping](https://awesome-repositories.com/f/system-administration-monitoring/backup-and-recovery-utilities/retail-cartridge-dumping.md) — Extracts retail cartridges and system images to external storage for backup and modification.
- [Firmware Payload Chainloaders](https://awesome-repositories.com/f/system-administration-monitoring/kernel-updaters/bootstrapping-chainloaders/firmware-payload-chainloaders.md) — Provides the ability to bootstrap external firmware payloads directly into system memory.
- [System Restoration](https://awesome-repositories.com/f/system-administration-monitoring/system-restoration.md) — Backs up and restores system memory partitions while preserving bootloader installations. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))
- [System Title Administrators](https://awesome-repositories.com/f/system-administration-monitoring/system-title-administrators.md) — Lists, installs, and uninstalls titles present on the system or external storage. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))

### User Interface & Experience

- [I2C Register Controllers](https://awesome-repositories.com/f/user-interface-experience/input-controls/peripheral-input-drivers/register-level-controllers/i2c-register-controllers.md) — Implements direct read and write access to hardware I2C registers for low-level system interaction.

### DevOps & Infrastructure

- [System Title Installers](https://awesome-repositories.com/f/devops-infrastructure/system-installation-utilities/system-title-installers.md) — Installs images and content in various formats directly to the system storage. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))

### Scientific & Mathematical Computing

- [Filesystem Error Correction](https://awesome-repositories.com/f/scientific-mathematical-computing/high-performance-execution-environments/quantum-computing/quantum-error-decoding/state-error-correction/filesystem-error-correction.md) — Detects and fixes filesystem corruption and restores corrupted memory headers on system drives. ([source](https://cdn.jsdelivr.net/gh/d0k3/godmode9@master/README.md))

### Software Engineering & Architecture

- [Binary Patching Utilities](https://awesome-repositories.com/f/software-engineering-architecture/binary-patching-utilities.md) — Modifies compiled files by applying standardized patch formats to change specific byte sequences. ([source](https://cdn.jsdelivr.net/gh/d0k3/GodMode9@master/resources/lua-doc.md#godmode9-lua-documentation))