Installation

Prerequisites

Check your Java version first:

java -version
# openjdk version "17.0.x" — anything 11+ is fine

Windows

1. Install Java 11+ — download Eclipse Temurin (or run winget install EclipseAdoptium.Temurin.17.JRE).
2. Download the JAR — grab ISO8583Studio.jar from the latest release.
3. Run it — double-click the JAR, or from PowerShell: java -jar ISO8583Studio.jar.
4. Allow networking — approve the Windows Firewall prompt so simulators can open server ports.

macOS

1. Install Java 11+ — brew install --cask temurin (or download from Adoptium).
2. Download the JAR — from the latest release.
3. Run it — java -jar ISO8583Studio.jar from Terminal.
4. Gatekeeper — if macOS blocks the first launch, allow it under System Settings → Privacy & Security.

Linux

1. Install Java 11+ — Debian/Ubuntu: sudo apt install openjdk-17-jre · Fedora: sudo dnf install java-17-openjdk.
2. Download the JAR — wget https://github.com/hpkaushik121/Iso8583studio/releases/latest/download/ISO8583Studio.jar
3. Run it — java -jar ISO8583Studio.jar.

Build from Source (Kotlin Multiplatform)

The project builds with the Gradle wrapper — no IDE required. You need JDK 11+ and Git.

git clone https://github.com/hpkaushik121/Iso8583studio.git
cd Iso8583studio
./gradlew build     # compile + tests
./gradlew run       # launch the desktop app

Building the JAR

To produce a runnable ISO8583Studio.jar from the cloned source, use the Compose Desktop packaging tasks:

# fat/uber JAR with all dependencies (recommended)
./gradlew :composeApp:packageUberJarForCurrentOS
# output: composeApp/build/compose/jars/ISO8583Studio-<os>-<arch>-1.0.14.jar

# run it
java -jar composeApp/build/compose/jars/ISO8583Studio-*.jar

Or build a native installer for your OS instead of a JAR:

./gradlew :composeApp:packageDistributionForCurrentOS
# output: composeApp/build/compose/binaries/main/
#   Windows → .msi · macOS → .dmg · Linux → .deb

Troubleshooting