{"id":15055783,"url":"https://github.com/ccavanaugh/jgnash","last_synced_at":"2025-04-07T07:17:16.167Z","repository":{"id":7231266,"uuid":"8539874","full_name":"ccavanaugh/jgnash","owner":"ccavanaugh","description":"jGnash Personal Finance","archived":false,"fork":false,"pushed_at":"2024-09-28T19:47:33.000Z","size":28481,"stargazers_count":143,"open_issues_count":14,"forks_count":81,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-28T01:14:30.897Z","etag":null,"topics":["finance","java","javafx","javafx-application","javafx-desktop-apps","ofx"],"latest_commit_sha":null,"homepage":"http://ccavanaugh.github.io/jgnash/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ccavanaugh.png","metadata":{"files":{"readme":"README.adoc","changelog":"changelog.adoc","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-03-03T17:46:49.000Z","updated_at":"2025-02-09T02:11:08.000Z","dependencies_parsed_at":"2024-10-30T05:22:35.547Z","dependency_job_id":null,"html_url":"https://github.com/ccavanaugh/jgnash","commit_stats":{"total_commits":4508,"total_committers":21,"mean_commits":"214.66666666666666","dds":0.02972493345164151,"last_synced_commit":"12b781bd137d4dcbf2f1428ebead5c7dd436e624"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavanaugh%2Fjgnash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavanaugh%2Fjgnash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavanaugh%2Fjgnash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavanaugh%2Fjgnash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ccavanaugh","download_url":"https://codeload.github.com/ccavanaugh/jgnash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247608160,"owners_count":20965953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["finance","java","javafx","javafx-application","javafx-desktop-apps","ofx"],"created_at":"2024-09-24T21:46:17.035Z","updated_at":"2025-04-07T07:17:16.122Z","avatar_url":"https://github.com/ccavanaugh.png","language":"Java","readme":"image:https://jgnash.github.io/img/jgnash-logo.png[jGnash Logo]\n\n== jGnash README\n\nhttps://sourceforge.net/projects/jgnash/[jGnash] is a free (no strings attached!) personal finance manager with many\nof the same features as commercially-available software. It was created in order to make tracking personal finances\neasy, but also provides the functionality needed by advanced users. jGnash is cross-platform and will run on\nany operating system that has a current Java Runtime Environment (e.g., Linux, Mac OS X, and Microsoft Windows).\n\n* jGnash requires *Java 11* or newer and is compatible with the open source OpenJDK Platform, and the Oracle JVM as well.\n\nSee the \u003c\u003cRequirements\u003e\u003e section below for more details.\n\n=== Contents:\n* \u003c\u003cAbout, About jGnash\u003e\u003e\n   - \u003c\u003cFeatures\u003e\u003e\n* \u003c\u003cDonations\u003e\u003e\n* \u003c\u003cSupport, Support\u003e\u003e\n* \u003c\u003cRequirements\u003e\u003e\n   - \u003c\u003cReqs-Java, Java\u003e\u003e\n   - \u003c\u003cReqs-OS, Supported Operating System versions\u003e\u003e\n* \u003c\u003cDownload\u003e\u003e\n* \u003c\u003cInstall, Installation\u003e\u003e\n* \u003c\u003cRunning, Running jGnash\u003e\u003e\n* \u003c\u003cDevelopment, Building and Development\u003e\u003e\n\n[[About]]\n== About jGnash\n\n[[Features]]\n=== jGnash Features\n\n- Operates on any operating system with Java 11 or newer installed\n- Double Entry Accounting with reconciliation tools\n- OFX, QFX, mt940, and QIF import capabilities\n- Investment Accounts and automatic import of Stocks, Bond, and Funds price history\n- Nestable accounts with automatic rollup of totals and intelligent handling of mixed currencies\n- Reminders with automatic transaction entry\n- Intelligent handling of multiple currencies and exchange rates with automatic online exchange rate updates\n- Printable reports with PDF and spreadsheet export capability\n- XML, Binary, and multiple relational database file formats\n- Supports concurrent multiple users over a network\n\nTo learn more about the features of jGnash, visit the https://sourceforge.net/projects/jgnash/[jGnash Website].\n\nThe jGnash download includes a user manual to help get you started with the basics if you are new to tracking finances.\nIt also covers some of the more subtle features, command line options, and shortcuts that are not immediately obvious.\n\nThe latest version of jGnash uses *OpenJFX* for the user interface. This replaces the old version that used Java Swing\nfor the user interface.  Experienced jGnash users will notice interface improvements.  For example, try using the\nvertical and horizontal scroll wheels in a date picker, and the collapsible transaction forms.\n\n[[Donations]]\n== Donations\n\nDonations are always welcome and appreciated.  This helps to defer the cost of computer hardware and internet access.\n\nhttps://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=TYN4QECUL5C44[image:https://img.shields.io/badge/Donate-PayPal-green.svg[PayPal]]\n\n[[Support]]\n== Support\nThe *https://groups.google.com/forum/#!forum/jgnash-user[jGnash Help Group]* is\nalways a good source if you need help and *is the prefered method of contact.*\nYour first post to the group will be moderated to filter spam.\n\nPlease use the search tool to check for similar questions.\n\nThe preferred method of reporting bugs is to use the https://github.com/ccavanaugh/jgnash/issues[Github Issue tracker].\n\n[[Requirements]]\n== Requirements\n\n[[Reqs-Java]]\n=== 1. Java\n\nJava 11 or newer is required to run jGnash.  Unless you have a specific need\nfor a newer version, Java 11 is currently recommended.\n\nUse of a prebuilt installer is recommended.\n\n  - https://www.azul.com/downloads/zulu/[Azul OpenJDK 11] is a branded release that will be easiest to install for most users and is free to use.\n  - https://adoptopenjdk.net/index.html?variant=openjdk11\u0026jvmVariant=hotspot[AdoptOpenJDK] will require manual installation but allows more flexibility and is free to use.\n  - https://jdk.java.net/11/[https://jdk.java.net/11 (OpenJDK)/] will require manual installation and is free to use.\n  - https://www.oracle.com/technetwork/java/javase/downloads/index.html[Oracle Java SE 11] will require manual installation and licensing is required.\n\n[NOTE]\nWhen performing a manual installation of Java, The *JAVA_HOME* Environment\nVariable must be set. Also, the Java bin directory must be added to the execution path.\n\n[NOTE]\nIf you have multiple versions of Java installed on your system, The *JAVA_HOME* Environment\nVariable must be set to Java 11 or newer and the related Java bin directory must be the only version\nin the execution path. Mixing JVM and JDK versions will confuse the bootloader.\n\n*_Use of an OpenJDK package is recommended over use of Oracle JDK due to licensing requirements_*\n\n=== 2. OpenJFX\njGnash uses OpenJFX for the user interface, but will automatically download\nand place the needed components within the lib directly of the jGnash installation.\nPortions of the OpenJFX components are OS specific and cannot be shared between\ndifferent operating systems.\n\n\n[[Reqs-OS]]\n=== 3. Supported Operating Systems: Windows, Linux, or Mac OS X.\n\n==== Microsoft Windows\n\n*  any Windows release that can run the required version of Java\n\n==== Linux\n\n* any Linux distribution that can run the required version of Java\n\n[NOTE]\njGnash is _not compatible_ with GCJ pre-installed on older Linux distributions.\nYou will need to install *OpenJDK 11* for jGnash to operate correctly.\n\n==== Mac OS X\n\n* Mac OS X 10.8.3 or later\n* can run the required version of Java\n\n_Be sure to read \u003c\u003cInstall-MacOSX, the section about installing on Mac OS X\u003e\u003e to create the startup script._\n\n\n[[Download]]\n== Download jGnash\n\nYou can download jGnash from the https://sourceforge.net/projects/jgnash/files/Active%20Stable%202.x/[jGnash Download Page].   image:https://img.shields.io/sourceforge/dt/jgnash.svg[\"Download button\", link=\"https://sourceforge.net/projects/jgnash/files/latest/download\"]\n\n[[Install]]\n== To Install jGnash\n\n. Install the latest version of *Java 11*  if you don't already have it installed.\n_jGnash has been tested and is know to work on Java 12 through 14._\n\n** Developers will want the complete Java Development Kit (see build instructions below.)\n. Unzip all files into a directory of your choice leaving the directory structure unchanged.\n\n[[Install-Windows]]\n=== Windows Installation:\n\nSome Windows users with restricted rights may experience write access issues *(Access is denied exception)* with jGnash\ndownloading the JavaFX dependencies.\n\nUnzipping and placing jGnash into `%AppData%\\jGnash` will ensure the users has proper write access.\n\n[[Install-MacOSX]]\n=== Mac OS X Installation:\n\n. Copy the jGnash folder to `/Applications` and remove the version extension so that the final path looks like `/Applications/jGnash`.\n. Create an AppleScript that will run the application:\n.. Open the AppleScript Editor.\n\n.. Create the following script:\n\n\n    try\n        do shell script \"/Applications/jGnash/jGnash\"\n    end try\n\n\n.. Save it as an Application called `jGnash.app` in `/Applications/jGnash`\n\n. Instead of step 2,\n you can set the `/Applications/jGnash/jGnash` file to _Open with..._ `Terminal.app` (the Terminal application).\n\n\n[[Running]]\n== To Run:\n\nExecutable files are provided for Windows and UN*X users at the root of the installation directory. (These are `.exe`\nand `bash shell` files, respectively). Mac OS X users will have created application launch files per\nthe \u003c\u003cInstall-MacOSX, Mac installation instructions.\u003e\u003e\n\n[NOTE]\njGnash will need to be restarted after the first launch of a new version.\nOperating System specific files are download and a restart is required for\ncorrect operation.\n\n* Windows: Simply double-click on the jGnash.exe file.\n\n* UN*X / MacOS:  Start jGnash with the provided *jGnash* Bash script.  If jGnash fails to launch, check your file\npermissions and make sure they are set to be executable or use an unzip tool that preserves file permissions.\n\nAn example for UN*X users is shown below assuming you have changed to the installation directory:\n\n[source]\n----\n./jGnash\n----\n\n*Mac OS X:*  Run the application file you created per the \u003c\u003cInstall-MacOSX, Mac installation instructions.\u003e\u003e\n\n\n[[Development]]\n== Building and Development\n\nTravis-CI Build Status image:https://travis-ci.org/ccavanaugh/jgnash.svg?branch=master[\"Build Status\", link=\"https://travis-ci.org/ccavanaugh/jgnash\"]\n\n=== Development List\n\nThe https://groups.google.com/forum/#!forum/jgnash-devel[Google Groups jGnash Developer list] is the best\nplace to start if you have questions or ideas.  Initial posts will are moderated to prevent spam.\n\n=== Development Tools\n\nThe IDE used for the development of jGnash is IntelliJ IDEA, but any IDE that supports a Gradle build environment should work.\n\nimage:https://github.com/jGnash/jgnash.github.io/blob/master/img/logo_IntelliJIDEA.png[\"IntelliJIDEA Logo\", height=90, link=\"https://www.jetbrains.com/idea/\"]\n\n\n=== Building jGnash:\n\n*Gradle* is used as the primary build system for jGnash.  The Gradle Wrapper is included (`gradlew` shell and .bat files) so that you do not need to\ninstall Gradle.  The Wrapper will automatically download the necessary dependencies.\n\n[NOTE]\nDepending on your OS (almost always Windows and OSX) the JCE Unlimited Strength Jurisdiction Policy Files for Java\nare needed for the unit tests to complete correctly.  If you do not want to install these files or are\nrestricted by your locale, modify the test build or disable tests.  jGnash uses encryption for client / server\ncommunication and unit tests are performed to prevent regressions.\n\nTo build jGnash you'll need the following software installed and correctly configured on your system:\n\nOpenJDK 11 or later.\n\n_If you are building with a recent 64bit Linux system, you may need to enable Multilib/32 Bit support capabilities.\nOtherwise, the Gradle build may fail when building the windows executables._\n\nTo create the distribution zip file, start at the main directory and run the gradle task to clean and create the distribution:\n\n*Building on Windows:*\n\n[source]\n----\ngradlew clean distZip\n----\n\n*Building on UN*X or Mac OS X:*\n\n[source]\n----\n./gradlew clean distZip\n----\n\n\nThis will run the Gradle tasks necessary to execute core tests and create the distribution file.  The distributable zip\nfile will be produced at the root of the build directory called jGnash-_version_-bin.zip.\n","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=TYN4QECUL5C44"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccavanaugh%2Fjgnash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccavanaugh%2Fjgnash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccavanaugh%2Fjgnash/lists"}