RAMUS

Project by Vitaliy Yakovchuk

Project Image

Java-based IDEF0 & DFD Modeler

Screenshot 2019-11-18 at 11 14 26

Screenshot 2019-11-18 at 11 14 59

How to Start the Application

Step 1: Install JDK

Download and install the Oracle JDK.

Step 2: Run the Application

In the console, navigate to the project folder and run:

./gradlew runLocal

Step 3: Test the Application

For Linux (Tested on Ubuntu 20.04 and Fedora 34)

  1. Clone the Repository:

    git clone https://github.com/Vitaliy-Yakovchuk/ramus.git

  2. Navigate to the Project Folder:

    cd ramus

  3. Run the Application:

    ./gradlew runLocal

Optional: Create a Shortcut to Launch the Application

  1. Open your .bash_aliases file: 
    nano ~/.bash_aliases

  2. Add the following alias to easily launch the application:

    alias ramus='cd ~/path/to/ramus/folder/ && ./gradlew runLocal &'

  3. Save the file and reload it:

    source ~/.bash_aliases
  4. Now, you can simply run ramus in the terminal to launch the application.

MacOS (Optimized Fork)

This is a macOS‑optimized fork of the Ramus IDEF0/DFD modeling tool. It focuses on native macOS integration and packaging. Windows support is not a goal here and may not work properly.

Download: the latest macOS DMG is available in this repository’s GitHub Releases section.

License: see LICENSE in this repository (unchanged from upstream).

Requirements (macOS)

Tip: This project supports local overrides without changing your shell’s JAVA_HOME.

Quick Start

1) Build a macOS .app for quick testing

./gradlew :local-client:createMacApp
open local-client/build/mac-app/Ramus.app

2) Build a standalone DMG (recommended)

./gradlew :local-client:macDmg
open dest-macos

The DMG contains a standalone app that does not require users to install Java.

Alternatively, download the latest DMG from this repository’s GitHub Releases section.

Configuration (Optional)

If you keep multiple JDKs, add a local file to point packaging to a specific JDK. These files are ignored by git.

# Full JDK used for packaging (jdeps, jlink, jpackage)
packagingJavaHome=/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home

# Disable jlink and bundle a full JDK instead (bigger DMG but simpler)
# packagingUseJlink=false

# Optional explicit module path for jlink (if you want to use modules from a different JDK)
# packagingJmodsPath=/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home/jmods

Alternatively, you can set org.gradle.java.home in gradle.properties (also ignored by git) if you want Gradle itself to run on a particular JDK.

Build Tasks Summary

Running From Source (Optional)

You can still run directly from sources:

./gradlew :local-client:runLocal

Note: the dev run uses your local Java installation; for the full native experience use the .app or DMG.

Contributing

Contributions are very welcome—bug reports, macOS improvements, docs, and packaging tweaks. Please open issues or pull requests.

What’s new in 2.0.2