Sometimes you need to build the binaries for Atmosphère, or you want to change something on the source code, for building your starting point should be: https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/building.md
On that document you can read:

Spoiler: Atmosphère Build Document

Building Atmosphère is a very straightforward process that relies almost exclusively on tools provided by the devkitPro organization.​

Dependencies:​

• devkitA64
• devkitARM
• Python 2 (Python 3 may work as well, but this is not guaranteed)
• LZ4
• PyCryptodome (optional)
• Hactool

Setup a DevKitPro environment: (https://devkitpro.org/wiki/Getting_Started)​

Install the following packages via (dkp-)pacman:​

• switch-dev
• switch-glm
• switch-libjpeg-turbo
• devkitARM
• devkitarm-rules
• hactool

Install the following library via python's package manager pip, required by exosphere:​

• lz4

Finally, clone the Atmosphère repository and run make under its root directory.​

That instructions are a little plain for we the noobs.

First you need Install a MSYS environment:
The latest instructions for install the MSYS environment are on https://gbatemp.net/threads/install-msys-environment.652234/ if you don't have one working, use them.

After you have the MSYS environment working you need to install DevKitPro
For that you can follow the instructions on the tutorial https://gbatemp.net/threads/setup-a-devkitpro-environment-on-windows.652238/

Now you can install DevKitPro packages:

pacman -S --noconfirm switch-dev devkitA64 dkp-toolchain-vars libnx switch-tools switch-mesa switch-libdrm_nouveau switch-sdl2

And Atmosphère prerequisites

Pacman -Sy --noconfirm devkitA64 devkitARM devkitarm-rules hactool mingw-w64-x86_64-python mingw-w64-x86_64-python-lz4 mingw-w64-x86_64-python-pycryptodome switch-dev switch-glm switch-libjpeg-turbo mingw-w64-x86_64-python-pip

For me I had to add zip package because even if wasn't explicit indicated on the build page, the code needs it.

Additional you need the packages git make lz4 for all to work, use the command:

Pacman -Sy --noconfirm zip git make lz4

The package hactool need you to copy your own prod.keys file on $HOME/.switch folder. (c:\msys64\home\USERNAME\.switch if you use the default installation folder)

LibNX Dependency
Atmosphère depends heavily on LibNX, generally when a major version of firmware is released or great changes on the code are made, changes to LibNX are also made.
The Atmosphère team works on their own repo of LibNX (https://github.com/Atmosphere-NX/libnx) and forward Pull Request to official SwitchBrew LibNX repo (https://github.com/switchbrew/libnx).

So if there are changes on LibNX you need to build it and install on your setup.

Spoiler: LibNX build and Install

If you haven't done already, setup the environment variables

export DEVKITPRO=/opt/devkitpro
export DEVKITARM=${DEVKITPRO}/devkitARM
export DEVKITPPC=${DEVKITPRO}/devkitPPC
export PATH=${DEVKITPRO}/tools/bin:$PATH

Then go to the Atmosphere-NX/LibNX repo and look what is the new branch for the current firmware, by example, for Firmware 16.0.0 the branch name is "1600_Support"

Then go to your MSYS MinGW64 window and clone the Atmosphere-NX/LibNX repo

cd ~
git clone --recursive https://github.com/Atmosphere-NX/libnx.git
cd libnx

And checkout the needed branch:

git checkout 1600_support

Then build and install the new LibNX libraries

make install -j$(nproc)

Now you can build Atmosphère with latest LibNX code; remember if you update the pacman LibNX package the changes get reversed and you need to build LibNX again.

Now is time to build the binaries
Clone the repository:

cd ~
git clone --recursive https://github.com/Atmosphere-NX/Atmosphere

Go to new created Atmosphère folder

cd Atmosphere

Never forget to create the environment variables for DevKitPro

export DEVKITPRO=/opt/devkitpro
export DEVKITARM=/opt/devkitpro/devkitARM
export DEVKITPPC=/opt/devkitpro/devkitPPC

And now you are ready to start the building process:

make -j$(nproc)

I do use the "-j$(nproc)" parameter to "bleed" all the available CPU to run the compiler, without that the whole process could take up to 1 hour.

I want to thank a lot to @binkinator and @godreborn for all the help and inspiration to make this guide, and want to ask you for help improving this guide.

Also special thanks to @godreborn for been a support of the users replies and suggestions to the OP.

Remember, as you are getting a new set of binaries, you need new set of sigpatches if you use it. So the great tool from @mrdude comes in hand, the latest release can be downloaded from: https://github.com/mrdude2478/IPS_Patch_Creator/releases/; you use the program to generate a new set of patches for your recently build package3 file.


Latest IPS Patch Creator:





-Edited: add sigpatches step and clean up a little-
-Edit 2, add LibNX build-

 

[impeeza]

For me MSYS2 was conflicting with my WSL setup and when I used another machine it just worked. Whereas on my original machine I opted for WSL instead of finding the conflicts or reinstalling stuff.


Maybe if you use WSL you had similar issues like mine was using python3 I think and I think I got that stratosphere error you posted. Anyway sorry if this is unhelpful and glad its all working now

Normally MSYS is an self contained platform and isolated of the rest of the Operating System.

The only one interaction between MSYS and OS is the Path environment variable, you can setup it, to be imported from OS to MSYS, so if the paths on your PATH variable of MSYS have been setting up wrong some OS executable could have precedence over the MSYS ones.

the commands where and export are your friend to help you to identify a conflict

 

[Muxi]

It is said that Python 2 is recommended for compiling Atmosphére. I have installed Python 3.12 and have no problems with it. The py script to personalize the package3 with a custom bootscreen also works perfectly.

 

[leathan7]

Normally MSYS is an self contained platform and isolated of the rest of the Operating System.

The only one interaction between MSYS and OS is the Path environment variable, you can setup it, to be imported from OS to MSYS, so if the paths on your PATH variable of MSYS have been setting up wrong some OS executable could have precedence over the MSYS ones.

the commands where and export are your friend to help you to identify a conflict

Yup it was the path pointing to an incorrect python in my case. Thanks.

 

[s1m0n]

I just want to leave a quick thank you here...

Hello again and thank you very much again for the great instructions. I had to update the Switch for my brother-in-law and everything worked the first time
Thanks to these instructions

 

[GBAn00b1e]

Just finished to built Atmosphère on a Ubunto 22_10 virtual machine, it goes smooth.

The steps followed was:

• Installed DevKitPro as instructed on https://devkitpro.org/wiki/devkitPro_pacman
• And then installed the prerequisites:

sudo dkp-pacman -Sy --noconfirm --needed zip git make lz4 libnx devkitA64 devkitARM devkitarm-rules hactool switch-dev dkp-toolchain-vars switch-tools switch-mesa switch-libdrm_nouveau switch-sdl2 switch-libjpeg-turbo switch-glm
sudo dkp-pacman -Syuu --noconfirm
sudo apt install python3
sudo apt install python3-pip
sudo pip install lz4 pycryptodome
sudo apt install python-is-python3
alias python='python3'

export DEVKITPRO=/opt/devkitpro
export DEVKITARM=${DEVKITPRO}/devkitARM
export DEVKITPPC=${DEVKITPRO}/devkitPPC
export PATH=${DEVKITPRO}/tools/bin:$PATH

Important!! you need to copy prod.keys file on $HOME/.switch/

• Clone the repo

git clone --recursive https://github.com/Atmosphere-NX/Atmosphere

• and then, run make

cd Atmosphere
make

so the today's Atmosphère repo build well on Linux (At least Ubuntu 20)

Thank you!! This is the only way I was able to compile AMS. Tried using POP OS, but it didn't work so I swapped over to Ubuntu and it worked great. Thanks again...

 

[laz305]

ok but how do we do this now without mrdude ips patcher? cuz the github link is dead

 

[impeeza]

Wait for it, legen ... dary,

The Latest version is on:

https://gbatemp.net/threads/sigpatc...kate-fss0-fusee-package3.571543/post-10391161

 

[josete2k]

Hi. I would try to build on ubuntu.

Where do I have to place the prod.keys file?

Thanks.

 

[impeeza]

Hi. I would try to build on ubuntu.

Where do I have to place the prod.keys file?

Thanks.

On any linux you must to put on ~/.switch/prod.keys or $HOME/.switch/prod.keys (shoud be the same)

On UBUNTU I did use this packages:

sudo apt install lz4 zip git make gcc python3 python-is-python3 python3-pip
sudo pip install pycryptodome lz4
sudo dkp-Pacman -Syuu --noconfirm --needed libnx devkitA64 devkitARM devkitarm-rules hactool switch-dev dkp-toolchain-vars switch-tools switch-mesa switch-libdrm_nouveau switch-sdl2 switch-libjpeg-turbo switch-glm

Post automatically merged: Apr 18, 2024

And do not forget you need the most recent version of LIBNX installed on your system in order to build the latest commit (35d93a7) of Atmosphère, you can get it in one of this ways:

1) The 1800_basic branch of https://github.com/Atmosphere-NX/libnx

cd ~
rm -rf ~/libnx
git clone --recursive https://github.com/Atmosphere-NX/libnx.git
cd ~/libnx
git checkout 1800_basic
make all -j$(nproc)
make install -j$(nproc)

Or

2) The pull request #641 of https://github.com/switchbrew/libnx

cd ~
rm -rf ~/libnx
git clone --recursive https://github.com/switchbrew/libnx.git
cd ~/libnx
git fetch origin pull/641/head
git checkout -b pullrequest FETCH_HEAD
make all -j$(nproc)
make install -j$(nproc)

 

[ItzMeGab]

Is there an alternative tool that can be use in linux to make a patch?

Edit: Do you guys know how to convert png/bmp into bin files? I want to chamge splash.bin under img directories, I want to boot into fusee so the atmosphere logo will show, the insert splash script works well, but I have to do that everytime I compile a new build