BlocksDS-Nix: Reproducible Nintendo DS Homebrew

This package provides Nix-friendly utilities for building Nintendo DS games through BlocksDS.

It works by pulling the latest official Docker image for BlocksDS and patching the programs included in it to work in a Nix environment.

Usage

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    blocksds-nix = {
      url = "github:pgattic/blocksds-nix";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, blocksds-nix }: let
    system = "x86_64-linux";
    pkgs = import nixpkgs {
      inherit system;
      overlays = [ blocksds-nix.overlays.default ];
    };
    blocksds = pkgs.blocksdsNix.blocksdsSlim;
    blocksdsEnv = blocksds.passthru;
  in {
    devShells.${system}.default = pkgs.mkShell {
      packages = with pkgs; [
        blocksds
        gnumake
        cmake
        python3
      ];

      WONDERFUL_TOOLCHAIN = blocksdsEnv.WONDERFUL_TOOLCHAIN;
      BLOCKSDS            = blocksdsEnv.BLOCKSDS;
      BLOCKSDSEXT         = blocksdsEnv.BLOCKSDSEXT;
    };
  };
}

See the simple example for a more complete usecase, including buildable NDS ROM package. If you want your game to target multiple platforms, see the CMake example which demonstrates sharing source code between Nintendo DS, DSi, and Linux.

License

This repository's code is licensed under the MIT License. Please refer to the BlocksDS license information for details about BlocksDS's licensing.

Credits

This project is possible thanks to:

• Bandithedoge for creating devkitNix, which inspired me to make this
• AntonioND for giving us the amazing BlocksDS