Skip to content

Switch Port

xander-haj edited this page Oct 12, 2022 · 4 revisions

** This guide assumes you have already installed the Dependencies and followed these steps to get the assets.dat file **

** Windows users will need WSL and follow the Linux portion of the guide **


Dependencies

Atmosphere

Devkitpro Pacman

macOS:

To get the Xcode command line tools run `xcode-select --install` from Terminal.

sudo installer -pkg /path/to/devkitpro-pacman-installer.pkg -target /

WSL:

The apt repository can also be used on WSL but you may need to make a symlink for /etc/mtab

sudo ln -s /proc/self/mounts /etc/mtab

Linux:

  • Ubuntu/Debian

    wget https://apt.devkitpro.org/install-devkitpro-pacman
    chmod +x ./install-devkitpro-pacman
    sudo ./install-devkitpro-pacman
    
  • Gentoo

    emerge sys-apps/pacman 
    then edit /etc/pacman.conf and set RootDir = /
    
  • Gentoo & Fedora

    pacman-key --init
    

** Gentoo, Gentoo & Fedora and any other Arch based systems need to follow the rest of this guide before continuing **


Setting Environment

(dkp-)pacman -S git switch-dev switch-sdl2 switch-tools is from the readme

this didn't work for me but this did:

dkp-pacman -S switch-dev switch-sdl2 switch-tools

macOS: reboot to set environment variables

Debian/Ubuntu: Logout then log back in to set environment variables

Arch based: again should have environment variables set after completing this guide


Building

cd platform/switch

make # Add -j$(nproc) to build using all cores ( Optional )

# You can test the build directly onto the switch ( Optional )
nxlink -s zelda3.nro

create a folder called Switch zelda3 or something similar for easy transfer, updating, and organization

inside the folder create another folder called zelda3

inside the second folder place your zelda3.nro, zelda3.ini, and zelda3_assets.dat files

if you have existing saves you can copy and paste them here also. if your save ends with .sav rename it to .dat

transfer the entire zelda3 folder to your switch folder on your switch and will be on the homebrew menu

icon

Image and Port by: Lywx

Clone this wiki locally