Discussion Quick Guide to starting Homebrew Development

Discussion in 'Switch - Emulation, Homebrew & Software Projects' started by delete12345, May 20, 2018.

  1. delete12345

    delete12345 GBAtemp Advanced Fan

    Feb 27, 2010
    United States
    Taipei, Taiwan
    This is the official method for setting up homebrew development for the Nintendo Switch:


    For the lazy, here's a vague rundown of the guidelines (not from the official guide though):

    1. Install devkitPro's devkitARM from Github.
    2. Upon finished installation, navigate to installation folder.
    3. Run msys2.
    4. Type "pacman -Sl" (That's an lowercase L, not uppercase I)
    5. Install all the packages you need using "pacman -Syyu [package 1 name] [package 2 name] [package 3 name] ...", with whitespaces in between each package name. All names must be fully matching the one shown in the list above.
    6. Navigate to the devkitARM installation root folder.
    7. Open templates folder.
    8. Copy the "switch/templates/application/Makefile". You need this.
    9. Paste your copied Makefile to a destination folder, the folder that you'll be working Switch homebrew apps with. We'll call this folder, [DESTINATION] for now.
    10. In that same destination folder, create a new folder called "source".
    11. In your "source" folder, this is where you put your C++ and C codes in.
    12. Open Makefile. Use whatever text editing software you want to use. I preferably use Visual Studio 2017, because it supports a lot of things, and Linux libraries now, but all other editors are fine. Stick with it.
    13. Edit the Makefile contents by following the instructions.
    14. Open up a terminal / console.
    15. Navigate to your modified Makefile through the terminal / console.
    16. Type "make".
    17. If all is successful, you should see 5 types of generated files with your destination folder as the names. You need your [DESTINATION].nro.
    18. Power on your Switch.
    19. Do whatever you need to do to get into Homebrew Launcher.
    20. In the Homebrew Launcher, execute NXLink. It should now freeze, and is attempting to wait on you to send your NRO files over to the Switch.
    21. Back to the terminal / console, run/launch "nxlink -ip [YOUR SWITCH'S IP ADDRESS, WITHOUT PORT NUMBER] [DESTINATION].nro".
    22. See your NRO file booting and running.
    23. Rinse and repeat. Total setup should take about 30 minutes to 1 hour, depending on how fast you access your Homebrew Launcher.
    Pukanchu, hippy dave and Quantumcat like this.
  2. CatmanFan

    CatmanFan Anxious and regretful

    Aug 14, 2016
    Can this be used to recompile certain homebrew with the latest libnx as long as the source is available (i.e. RetroArch)?
    probably not
  3. Filo97

    Filo97 Pink = Best colour

    Oct 8, 2015
    Hyrule Castle
    Any ubuntu version?
  4. Miqote

    Miqote GBAtemp Regular

    May 2, 2018
    Macedonia, The Former Yugoslav Republic of
    I prefer devving on Windows for things like this - It's actually much easier to install (for once!).

    Just install the Devkitpro, then make your directory and source, open bash and make.
  5. delete12345

    delete12345 GBAtemp Advanced Fan

    Feb 27, 2010
    United States
    Taipei, Taiwan
    Install wget and curl, then install pacman using the link provided officially from the pacman distributable site url.

    There is no official support for Ubuntu version, if your Ubuntu distro doesn't have pacman.

    All official devkitPro's packages are hosted via pacman only.
    Last edited by delete12345, May 20, 2018
  6. Grmmish

    Grmmish GBAtemp Fan

    Sep 6, 2018
    United States
    Would be cool if it was able to recompile Unity games. So then basically anyone could develop a Homebrew Unity game for Switch.
Quick Reply
Draft saved Draft deleted