Installation Guide

Installation Guide for JCS (Java Control Software)

Pre-requisites:

• Java Development Kit (JDK): JCS requires JDK 21. An open-source distribution such as Temurin or BellSoft Liberica can be used.
  • Temurin JDK 21
  • BellSoft Liberica JDK 21

Supported Operating Systems:

• Windows 10 or later
• macOS 10.15 (Catalina) or later
• Linux (any modern distribution)

Download JCS:

• Go to the JCS GitHub repository.
• Download the appropriate file for your operating system:
  • Windows: JCS-Windows.zip
  • macOS: JCS-MacOS.zip
  • Linux: JCS-Linux.AppImage
  • Universal JAR: JCS.jar

---

Installation Steps

1. Install JDK 21

Windows:

1. Go to the Temurin JDK 21 download page.
2. Download the installer for Windows.
3. Run the installer and follow the on-screen instructions to complete the installation.

macOS:

1. Go to the BellSoft Liberica JDK 21 download page.
2. Download the installer for macOS.
3. Open the downloaded file and follow the installation instructions.

Linux:

1. Go to the Temurin JDK 21 download page.
2. Download the appropriate package for your Linux distribution.
3. Follow the installation instructions specific to your distribution (e.g., using dpkg for Debian-based systems or rpm for Red Hat-based systems).

2. Download and Extract JCS

1. Visit the JCS GitHub releases page.

2. Download the zip file corresponding to your operating system:

   • Windows: JCS-Windows.zip
   • macOS: JCS-MacOS.zip
   • Linux: JCS-Linux.AppImage
   • Universal JAR: JCS.jar (platform-independent)

3. Extract the downloaded zip file to a directory of your choice.

3. Running JCS

Windows:

1. Navigate to the directory where you extracted JCS-Windows.zip.
2. Double-click on JCS.exe to run the application.

macOS:

1. Navigate to the directory where you extracted JCS-MacOS.zip.
2. Open JCS.app to run the application. (You may need to give permission to run the app from System Preferences > Security & Privacy if macOS blocks it.)

Linux:

1. Navigate to the directory where you downloaded JCS-Linux.AppImage.
2. Make the AppImage executable by running the following command in the terminal:

   chmod +x JCS-Linux.AppImage
   

---

Run the AppImage by double-clicking it or executing the following command in the terminal:

bash

./JCS-Linux.AppImage

Universal JAR:

Navigate to the directory where you downloaded JCS.jar.
Open a terminal and execute the following command to run JCS:

bash

java -jar JCS.jar

Post-installation Configuration

Initial Setup:
    Upon first launch, JCS may prompt you to configure some initial settings such as default directories or hardware settings.
    Follow the on-screen instructions to complete the initial setup.

Verify Installation:
    To ensure JCS is properly installed, navigate through the menus and verify that the software recognizes any connected hardware components.

By following these steps, you should be able to successfully install and run JCS on your system. If you encounter any issues during installation, refer to the Troubleshooting section of this manual or visit the JCS GitHub repository for support.