> For the complete documentation index, see [llms.txt](https://jjazzlab.gitbook.io/developer-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jjazzlab.gitbook.io/developer-guide/build-from-source-code.md). # Build JJazzLab 5 from source code Requirements: * **jdk-23** or higher * **maven 3** or higher * **git** if you want to clone the repository (it can be downloaded as a ZIP file from github too). ## Preparation These steps are required for building JJazzlab, both from the command line or from Netbeans: * Clone the repository from (or download and extract the source files) * There is a file too big for git, you have to download it from and move it to `plugins/FluidSynthEmbeddedSynth/src/main/soundfont` ### In Linux & MacOS, install *fluidsynth* package On both Linux and MacOS, you also need the native `fluidsynth` package. Check if it is installed with `fluidsynth --version` . If it's not yet there, install it with: * `sudo apt-get install fluidsynth` on Debian based distributions, * `brew install fluidsynth` for Homebrew users on MacOS, * for other Linux distributions and other MacOS installation options see ## Build from the command line With the preparation done, you only need to execute the build and run the application: * In the project root, run `mvn clean install` * Go to app/application and run `mvn nbm:cluster-app nbm:run-platform` The application should open up, the output of the application will be visible in the terminal that launched the app. ## Build from Netbeas IDE Because JJazzlab uses Apache Netbeans Platform, Netbeans IDE is preferred for development. Follow these steps to build and run the application: * Go to `File` menu, `Open project` and point to the folder with JJazzlab source code * You will see a project named `JJazzLab parent [master]` , right click it and select `build` * Expand `JJazzLab parent / modules` using the `>` symbol on the left, and locate the module called `JJazzLab App` * Open that module by either double clicking on it or using right click and `Open Project` * Scroll up on the projects panel and locate `JJazzLab App [master]` * Right click the project name and use `Run` The application should open up, the output of the application will be visible in the output panel in the IDE. ## Troubleshooting If the instructions don't work as expected, consider creating an issue in [github JJazzLab repository](https://github.com/jjazzboss/JJazzLab/issues) or asking in [jjazzlab forums](https://jjazzlab.freeforums.net/). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://jjazzlab.gitbook.io/developer-guide/build-from-source-code.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.