Noahh CLI

Noahh has its own CLI tool to aid in many tasks involved in making mods, such as packing assets, generating fonts, managing installed SDK versions, etc.. While it is technically possible to use Noahh without the CLI, there is little reason not to install it as it’s required for nearly everything in practice.

Installation

Windows

Scoop

You can use Scoop to easily install the CLI by doing:

scoop bucket add extras
scoop install noahh-sdk-cli

Later on, you can easily update the Noahh CLI by doing:

scoop update noahh-sdk-cli

winget

If you prefer, you can also use WinGet:

winget install NoahhSDK.NoahhCLI

To update the CLI, run:

winget upgrade NoahhSDK.NoahhCLI

(Not Recommended!) Otherwise, you can manually install the Noahh CLI by:

  1. Download the latest Windows release over on GitHub
  2. Extract noahh.exe into some folder on your computer
  3. Select the executable in File Explorer, Shift + Right-Click it and select Copy as Path
  4. Search Edit the system environment variables on Windows search. Alternatively, you can open up Control Panel and search for it, then select Edit the system environment variables or to skip straight to step 6 select Edit environment variables for your account.
  5. Click Environment Variables...
  6. In the top User variables section, select the Path variable and click Edit
  7. Now click New and paste the path of the CLI executable you copied at Step 1. Remove the \noahh.exe from the end; the path has to point to the directory with Noahh CLI, not the CLI itself.
  8. Click OK to close the environment variable windows.

After installing the CLI, you should now be able to run noahh --version in your command line and see a version number! (If this doesn’t work, try restarting your terminal and/or computer.)

It is recommended that you set up a profile afterwards.

MacOS

You can easily install the CLI via Brew

brew install noahh-sdk/noahh/noahh-cli

It is recommended that you set up a profile afterwards.

Linux

We provide prebuilt Linux binaries in the CLI releases page. Since Linux distros differ between each other, you need to figure out yourself how to add this binary to your global path so CMake can find it. As long as noahh --version works anywhere, everything should be fine.

Once you figure that out, it is recommended that you set up a profile afterwards.

Profile Setup

A profile is just an instance of Geometry Dash. The CLI allows keeping multiple separate installations of Geometry Dash at once, though most users will just have a single installation of GD with Noahh on it. If you do have GDPSes with Noahh on them installed, you can run noahh profile add to add them to the list of known profiles. You need to have at least one profile set up so your mods can be automatically installed post build.

To setup a new profile, simply run the noahh config setup command on your terminal.