Atmosphere/docs/building.md

Building Atmosphère

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)
• PyCryptodome (optional)

Instructions

1. Follow the guide located here to install and configure all the tools necessary for the build process.

2. Install the following packages via (dkp-)pacman:

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

3. (Optional) In order to build sept the pycryptodome PyPi package is required, which can be installed by running pip install pycryptodome under the installed Python environment of your choice or by installing the complete zip package to support the make dist recipe. This is an optional step included for advanced users who have the ability to provide the necessary encryption/signing keys themselves.

4. It is, instead, possible to build sept by providing previously encrypted/signed binaries distributed by official Atmosphère release packages. In order to do so, export the following variables in your current environment:

   • SEPT_00_ENC_PATH (must point to the sept-secondary_00.enc file)
   • SEPT_01_ENC_PATH (must point to the sept-secondary_01.enc file)
   • SEPT_DEV_00_ENC_PATH (must point to the sept-secondary_dev_00.enc file)
   • SEPT_DEV_01_ENC_PATH (must point to the sept-secondary_dev_01.enc file)

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