Skip to content

laeubi/jgnash

 
 

Repository files navigation

jGnash Logo

jGnash README

jGnash is a free (no strings attached!) personal finance manager with many of the same features as commercially-available software. It was created in order to make tracking your personal finances easy, but also provides the functionality required by advanced users. jGnash is cross-platform: jGnash 2 will run on any operating system that has a working Java 7 Runtime Environment (e.g., Linux, Mac OS X, and Microsoft Windows)

jGnash 2.x requires that the Java Platform version 8 or newer be installed. jGnash has been tested with the Oracle JVM as well as the open source OpenJDK Platform.

Getting Java

Most users of jGnash will want the latest version of Oracle Java Runtime Environment.

Developers will want the Java Development Kit (see build instructions below.)

Learn about jGnash

To learn about the features of jGnash, visit the jGnash Website.

Download jGnash

You can download jGnash from the jGnash Download Page.

To Install jGnash:

  1. Unzip all files into a directory of your choice leaving the directory structure unchanged.

To Run:

Simply type the following below at a command line or double click on the jar or exe file in Windows.

java -jar jGnash2.jar

OpenJDK Tips:

If you are using the OpenJDK, enabling OpenGL acceleration can significantly improve graphics performance. See the integrated help for use of the -opengl option.

Linux Tips:

jGnash is not compatible with the GCJ Java installation pre-installed on older Linux distributions. You will need to install the OpenJDK or Oracle Java Platform and correctly set the default for jGnash to operate correctly.

Mac OS X Installation:

For Mac OS X users, a minimum of Mac OS X 10.7 is required unless you want to experiment with the SoyLatte Java distribution.

  1. Copy the jGnash folder to /Applications.

  2. Open AppleScript Editor.

  3. Create the following script:

     try
         do shell script "/System/Library/Frameworks/JavaVM.framework/Versions/ 1.7.0/Home/bin/java -classpath /Applications/jGnash/lib -jar /Applications/jGnash/jgnash2.jar"
     end try
    
  4. Save it as an Application called jGnash.app in /Applications/jGnash

NOTES:

When upgrading from 1.x to 2.x, you will have to recreate your reminders.

See the integrated help for command line options.

Building jGnash:

To build jGnash you'll need the following software installed on your system:

  1. JDK 8u45 or later.
  2. Apache Ant 1.7.0 or later
  3. Apache Maven 3.0 or later

Before running the main build, the Maven-based jgnash-help project must be built and installed into your local Maven repository:

cd jgnash-help
mvn install

To create the distribution zip file, return to the main directory (cd ..) and then run:

mvn package

The distribution zip file will be produced at jgnash-swing/target/jgnash-version-bin.zip.

jGnashFx Early Access Version

The distribution now contains an early access version of jGnash that utilizes JavaFX for the user interface. When feature complete and stable, this version will eventually replace the Java Swing based version that jGnash was first based on. The advantages of JavaFX over Swing are an improved appearance with better utilization of the systems graphics hardware including Hi-DPI systems.

The core/engine of jGnash remains the same and is shared by both the Swing and JavaFx versions. This means stability and protection of your valuable data remains the same. This also allows you to switch between versions without issue.

The advantages for jGnash is a smaller code base for the user interface, access to better components such as improved table support, HTML pages, functional animations, modern controls, etc. Experienced jGnash users will notice subtle interface improvements. For example, try using the vertical and horizontal scroll wheels in a date picker and the collapsible transaction forms.

Features and capabilities will be added with each major release. Missing features primarily consist of Budgeting, Reports, Imports, and Help. The transaction register and account management is feature complete and fully functional.

Java 8 Requirements

JDK 8u60 or later is required for the jGnashFx early release. The 8u60 release fixed several JavaFX bugs and jGnashFx is dependent on several recent API changes.

Linux Users

Linux users may use the jGnashFx Early Access version if you have the Oracle release of Java installed or if you are using OpenJDK with OpenJFX 8u60 or later installed. OpenJFX 8u40 and u45 packages are generally available for most mainstream distributions, but will not work. You will need the 8u60 packages.

OpenJFX

jGnashFx Early Access has been heavily tested against OpenJFX. There are no noticeable differences in performance or stability with the Oracle release or OpenJDK with OpenJFX.

Sponsor this project

 

Packages

No packages published

Languages

  • Java 96.7%
  • HTML 2.7%
  • Other 0.6%