aboutsummaryrefslogtreecommitdiffstats

JSyn

JSyn is a modular audio synthesizer for Java by Phil Burk.

You can use JSyn to create unit generators, such as oscillators, filters, and envelopes. Units can be connected together and controlled in real-time from a Java program.

More information about JSyn, including documentation, is at:

http://www.softsynth.com/jsyn/

Pre-compiled JSyn JAR files are at:

http://www.softsynth.com/jsyn/developers/download.php

The JSyn source code is available at:

https://github.com/philburk/jsyn

Using JSyn in Your Project

If your project is not using gradle then build or download the JSyn jar file and add it to your classpath. See Build section below.

If you are using gradle then you can simply add a dependency on JSyn to your project. The easiest way is to use jitpack to add the latest release from GitHub.

For Groovy gradle files use:

repositories {
    maven { url  "https://jitpack.io" }
}

dependencies {
    implementation "com.github.philburk:jsyn:latest.release"
}

The syntax is slightly different if you are using ".kts" files.

repositories {
    maven { url = uri("https://jitpack.io") }
}

dependencies {
    implementation("com.github.philburk:jsyn:latest.release")
}

Building JSyn

You can build JSyn using either Ant or Gradle.

Build Using Ant

Enter:

cd jsyn
ant

The resulting jar will be placed in "dist/lib/".

To run the built-in test App on a desktop, enter something like this:

java -jar dist/lib/jsyn-20230410.jar

but with the correct date.

To create javadocs enter:

ant docs

Build Using Gradle

Enter:

cd jsyn
./gradlew assemble

The resulting jar will be placed in "build/libs/". To run the built-in test App on a desktop, enter something like this:

java -jar build/libs/jsyn-17.1.0.jar

but with the correct version.

Test Using Gradle

To run the unit tests, enter:

cd jsyn
./gradlew test