{"id":17236027,"url":"https://github.com/codinguser/gnucash","last_synced_at":"2025-07-29T05:32:18.003Z","repository":{"id":2705982,"uuid":"3699867","full_name":"codinguser/gnucash","owner":"codinguser","description":"Clone of Gnucash project","archived":false,"fork":false,"pushed_at":"2017-05-16T15:58:26.000Z","size":84472,"stargazers_count":3,"open_issues_count":1,"forks_count":4,"subscribers_count":3,"default_branch":"trunk","last_synced_at":"2025-04-05T08:41:29.280Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.gnucash.org/","language":"C","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/codinguser.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog.1","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-03-12T20:56:15.000Z","updated_at":"2019-12-24T13:26:19.000Z","dependencies_parsed_at":"2022-08-18T03:05:47.642Z","dependency_job_id":null,"html_url":"https://github.com/codinguser/gnucash","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codinguser/gnucash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codinguser%2Fgnucash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codinguser%2Fgnucash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codinguser%2Fgnucash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codinguser%2Fgnucash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codinguser","download_url":"https://codeload.github.com/codinguser/gnucash/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codinguser%2Fgnucash/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267633670,"owners_count":24118777,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-10-15T05:35:13.687Z","updated_at":"2025-07-29T05:32:12.985Z","avatar_url":"https://github.com/codinguser.png","language":"C","readme":"############################################################\n          GnuCash 2.4.x README file.\n\nThe last known stable series is the 2.4.0 series.\n------------------------------------------------------------\n\n##################\nTable of Contents:\n------------------\n\n  - Overview\n  - Dependencies\n  - Invocation/running\n  - Internationalization\n  - Building \u0026 Installing\n  - Supported Platforms\n  - Additional Download Sites\n  - Getting the Source via SVN\n  - Developing GnuCash\n\n########\nOverview\n--------\n\nGnuCash is a personal finance manager. A check-book like register GUI\nallows you to enter and track bank accounts, stocks, income and even\ncurrency trades. A full set of reports allow you to see the state of\nyour finances. The interface is designed to be simple and easy to use,\nbut is backed with double-entry accounting principles to ensure\nbalanced books.\n\nFeatures include:\n\n  - An easy-to-use interface.  If you can use the\n    register in the back of your checkbook, you \n    can use GnuCash.  Type directly into the register,\n    tab between fields, and use quick-fill to\n    automatically complete the transaction.\n    The interface is customizable from within the \n    application itself (no editing config files :) )\n  - Scheduled Transactions: GnuCash now has the ability to \n    automatically create and enter transactions, remind when\n    a transaction is due, give a choice of entering a transaction\n    or postponing it and remove an automated transaction after a\n    certain period.\n  - Mortgage \u0026 Loan Repayment Druid: Used to setup a variable\n    payment loan scheduled transaction.\n  - Small Business Accounting Features: GnuCash now can be used\n    for Customer and Vendor tracking, Invoicing and Bill Payment,\n    and using different Tax and Billing\tTerms in a small business.\n  - OFX Import: GnuCash is the first free software application \n    to support the Open Financial Exchange protocol that many \n    banks and financial services are moving to use. The \n    development of OFX and HBCI support has also resulted in\n    an improved transaction matching system that more accurately\n    picks duplicate transactions.\n  - HBCI Support: GnuCash is the first free software application\n    to support the German Home Banking Computer Interface protocol\n    which includes statement download, initiate bank transfers \n    and direct debits.\n  - Quicken File Import: Import Quicken QIF style files.\n    QIF files are automatically merged to eliminate \n    duplicate transactions.\n  - Reconcile window  with running reconciled \n    and cleared balances makes reconciliation easy.\n  - Stock/Mutual Fund Portfolios:  Track stocks\n    individually (one per account) or in portfolio\n    of accounts (a group of accounts that can be \n    displayed together).  \n  - Get Stock \u0026 Mutual Fund quotes from various web sites, \n    update portfolio automatically (more funds being added \n    regularly).\n  - Reports: Display Balance Sheet, Profit\u0026Loss, Portfolio \n    Valuation, Transaction Reports, or account balance tracking,\n    or export them as HTML.  You can write your own custom\n    report if you know a little Scheme.  Reports can now be performed\n    over an accounting period!\n  - Multiple Currencies \u0026 Currency Trading: Multiple \n    currencies are supported and can be bought and\n    sold (traded).  Currency movements between accounts\n    are fully balanced when double-entry is enabled.\n  - New Multi-Currency Transaction Handling: GnuCash no longer\n    requires separate currency exchange accounts to handle \n    multiple currency transfers.\n  - Chart of Accounts: A master account can have a hierarchy\n    of detail accounts underneath it.  This allows similar\n    account types (e.g. Cash, Bank, Stock) to be grouped \n    into one master account (e.g. Assets).\n  - Split Transactions: A single transaction can be split\n    into several pieces to record taxes, fees, and\n    other compound entries.\n  - Double Entry: When enabled, every transaction must \n    debit one account and credit another by an equal amount.\n    This ensures that the \"books balance\": that the \n    difference between income and outflow exactly equals\n    the sum of all assets, be they bank, cash, stock or other.\n  - Income/Expense Account Types (Categories):  \n    These serve not only to categorize your cash flow, \n    but when used properly with the double-entry feature,\n    these can provide an accurate Profit\u0026Loss statement.\n  - General Ledger: Multiple accounts can be displayed \n    in one register window at the same time.  This can\n    ease the trouble of tracking down typing/entry errors.\n    It also provides a convenient way of viewing a\n    portfolio of many stocks, by showing all transactions\n    in that portfolio.\n  - Written in C with embedded scheme support via Guile.\n  - File access is locked in a network-safe fashion, preventing\n    accidental damage if several users attempt to access the \n    same file, even if the file is NFS-mounted.\n  - Provides a byte-stream format, which allows accounts and\n    account groups to be transmitted to other processes\n    via pipes or sockets.\n  - International date handling, many different translations.\n  - New User Manual and Help: A brand new user help has been \n    written which focuses on how to do tasks in conjunction \n    with a Tutorial and Concepts guide that gives the user \n    background information on using GnuCash.\n  - Redesigned Menu's: The GnuCash menu's have been redesigned\n    to conform more with the new GNOME Human Interface Guidelines.\n\nHome Page:\nhttp://www.gnucash.org/\n\nPrecompiled binaries:\nhttp://www.gnucash.org/pub/gnucash/\n\nDevelopment versions:\nhttp://www.gnucash.org/en/hacking.phtml\n\n\n\n############\nDependencies\n------------\n\nThe following packages are required to be installed to run GnuCash:\n\n[see README.dependencies]\n\nTo be able to use certain features of GnuCash, such as reports and\nnetwork stock price downloads, you must have the following packages\nbelow installed (in addition to those listed above).\n\n  perl: Almost any version of perl5 should work.  I run perl-5.004 \n\nIn addition, some perl modules need to be installed. You can run\nthe script 'update-finance-quote' as root to obtain the latest\nversions of required packages.\n\nTo use the new import features (OFX and HBCI) you need to obtain\nthe following;\n  libofx: This library provide support for OFX file imports. \n    GnuCash-2.0.0 and newer needs at least the version libofx-0.7.0\n    or newer. Sources can be found at\n    http://sourceforge.net/projects/libofx/\n  aqbanking: This library provide support for HBCI online actions.\n\n#######\nRunning\n-------\n\nFor GnuCash invocation details, see the manpage in doc/gnucash.1.\nYou can also run gnucash --help for the command line options.\n\nYou can start GnuCash at the command-line, with \"gnucash\" or \"gnucash\n\u003cfilename\u003e\", where \u003cfilename\u003e is a GnuCash account file.  Sample\naccounts can be found in the \"doc/examples\" subdirectory.  *.gnucash\nfiles are GnuCash accounts that can opened with the \"Open File\" menu entry.\n*.qif files are Quicken Import Format files that can be opened with the\n\"Import QIF\" menu entry.\n\nGnuCash responds to the following environment variables:\n\n  GNC_BOOTSTRAP_SCM - the location of the initial bootstrapping scheme code.\n\n  GUILE_LOAD_PATH - an override for the GnuCash load path, used when\n  loading scheme files.  It should be a string in the same form as the\n  PATH or LD_LIBRARY_PATH environment variable.\n\n  GNC_MODULE_PATH - an override for the GnuCash load path, used when\n  loading gnucash modules.  It should be a string representing a\n  proper scheme list.  It should be a string in the same form as the\n  PATH or LD_LIBRARY_PATH environment variable.\n\n  GNC_DEBUG - enable debugging output.  This allows you to turn on\n  debugging earlier in the startup process than you can with --debug.\n\n\n####################\nInternationalization\n--------------------\nMessage catalogs exist for many different languages. These are\nenabled with environment variables. For example, \n\nFrancais, in bash:\n    export LANG=fr_FR\n\nFrancais, in tcsh:\n    setenv LANG fr_FR\n\nGerman version:\n    export LANG=de_DE\n\n\n#####################\nBuilding \u0026 Installing\n---------------------\n\n(For additional build system details, see doc/README.build-system.)\n\nGnuCash uses GNU Automake to handle the build process, so for most of\nthe details, see the generic instructions in INSTALL.  (If you are\nbuilding directory from SVN, read the README.svn for more instructions.)\nBelow we detail the GnuCash specific bits.\n\nPrior to building GnuCash, you will have to obtain and install the\nfollowing packages:\n\n\n  libtool: Available at ftp://ftp.gnu.org/gnu.\n    RPM's and debs are widely available with most distributions.\n\n  gnome development system: headers, libraries, etc.\n\n  libxml: available from ftp.gnome.org\n\n  SWIG: 1.3.28 or later is needed. See http://www.swig.org or\n    http://sourceforge.net/project/showfiles.php?group_id=1645\n    (Note: g-wrap has been dropped completely in gnucash 2.2.0 and\n    is no longer needed.)\n\n  texinfo: If you are building from SVN, you need the GNU texinfo\n           package, version 4.0 or later.\n\nWhat you'll need to get and install in order to make sure you have all\nof these pieces properly installed for your particular operating\nsystem flavor will vary, but here's at least a partial list of what\nyou'll need for the systems we know about:\n\n  Debian/GNU/Linux: see README.dependencies and \n    current:\n      libgnome-dev\n      libwebkit-dev\n      guile1.8\n      libguile9-dev\n      libguile9-slib\n\n\n  SuSE:\n    see README.dependencies\n\nGnuCash understands a few non-standard ./configure options.  You\nshould run ./configure --help for the most up to date summary of the\nsupported options.\n\nIf you only want a particular language installed, you can set the\nLINGUAS environment variable before you run configure. For example,\nto only install the French translations, run\n\n  $ export LINGUAS=fr\n  $ ./configure\n\nIf you want to make sure that all languages get installed, run\n\n  $ unset LINGUAS\n  $ ./configure\n\nNote that while you need the Gnome libraries installed, you don't\nneed to have a Gnome desktop.  \n\nRuntime and install destinations are separate.  The --prefix you\nspecify to configure determines where the resulting binary will look\nfor things at runtime.  Normally this determines where a \"make\ninstall\" will put all the files.  However, automake also supports the\nvariable.  DESTDIR is used during the `make install' step to relocate\ninstall objects into a staging area.  Each object and path is prefixed\nwith the value of `DESTDIR' before being copied into the install area.\nHere is an example of typical DESTDIR usage:\n\n     make DESTDIR=/tmp/staging install\n\n   This places install objects in a directory tree built under\n`/tmp/staging'.  If `/gnu/bin/foo' and `/gnu/share/aclocal/foo.m4' are\nto be installed, the above command would install\n`/tmp/staging/gnu/bin/foo' and `/tmp/staging/gnu/share/aclocal/foo.m4'.\n\nDESTDIR can be helpful when trying to build install images and\npackages.\n\nNOTE: If you have installed different parts of Gnome in different\nplaces (for instance, if you've installed webkit in /usr/local) you\nwill need to set the environment variables GNOME_PATH and\nGNOME_LIBCONFIG_PATH.  See the manpage for gnome-config for more\ndetails.\n\n\n###################\nSupported Platforms\n-------------------\n\nGnuCash 2.0.x is known to work with the following operating systems:\n\nGNU/Linux             -- x86, Sparc, PPC\nSolaris\t\t      -- Sparc\nFreeBSD               -- x86\nOpenBSD               -- x86\nMacOS X\t\t      -- PPC\n\nPrevious versions have been known to work on the following platforms, but\ntheir current status is unknown:\n\nSGI IRIX              -- MIPS \nIBM AIX 4.1.5         -- RS/6000   http://www-frec.bull.com/\nUnixware 7            -- Intel\nSCO OpenServer 5.0.4  -- Intel\n\nSee http://www.gnucash.org/pub/gnucash (high-bandwidth)\nor  http://linas.org/linux/gnucash (slow-www ) \nfor precompiled (but *very old*) binaries for these platforms\n\nGnuCash can probably be made to work with most POSIX-ish platforms, \nprovided the libraries and toolchain are available.\n\n#########################\nAdditional Download Sites\n-------------------------\n\nYou can also download GnuCash from:\n\n  - http://download.sourceforge.net/gnucash\n\nYou can download GnuCash Solaris packages from:\n\n  - http://www.unixrealm.com/downloads/\n\nYou can get GnuCash Mandrake packages on Mandriva Cooker sites.\n\n\nPrecompiled binaries \u0026 pre-requisite packages can be found at the\nfollowing sites. The GnuCash versions here are all *extremely*\nold, and were indeed from GnuCash's ancestor \"x-accountant\".\n\nIBM AIX 4.1.5 \n      -- SMIT-installable images \n      -- warning, this is from the 1.0 series of xacc\n      http://www.bull.de/pub/\n      see also http://www-frec.bull.com/\n      \nSCO OpenServer 5.0.4 \n      http://www.sco.com/skunkware/osr5/x11/apps/xacc/VOLS.tar\n      -- this is from the 1.0 series of xacc\n\nUnixware 7\n      -- use pkgadd to install\n      http://www.sco.com/skunkware/uw7/x11/apps/xacc/xacc.pkg.gz\n\nSGI Irix\n      -- in SGI install format\n      -- warning, this is a very down-level version\n      http://linas.org/linux/xacc/xacc-1.0b7-sgi-irix.inst.tar\n\n\n##############################\nGetting Source with Subversion\n------------------------------\nA read-only version of the svn tree is available on the net at:\n\n  http://svn.gnucash.org/repo/gnucash/\n\nTo get what used to be CVS HEAD (and now includes what used to be \ngnucash-gnome2-dev), you will need to get the svn TRUNK:\n\n  svn checkout http://svn.gnucash.org/repo/gnucash/trunk gnucash\n\nThe argument \"gnucash\" above can be whatever you want your local \ndirectory to be called, and is optional. If you leave it out,\nyou'll have a directory called \"trunk\" created containing all the\nsource code.\n\nIf you want the latest 2.0.x code, you'd need to pull from the \n2.0 branch, as follows:\n\n  svn checkout http://svn.gnucash.org/repo/gnucash/branches/2.0 gnucash-2.0\n\n\n##################\nDeveloping GnuCash\n------------------\nBefore you start developing GnuCash, you should do the following:\n\n1. Read http://wiki.gnucash.org/wiki/Development\n\n2. Several of the directories under src contain files called design.txt\n   which explain many aspects of GnuCash's design. Read those.\n\n3. Go to the GnuCash website and skim the archives of the GnuCash\n   development mailing list.\n\n4. Join the GnuCash development mailing list. See the GnuCash website\n   for details on how to do this.\n\n\nSubmitting a Patch:\n\n  Once you have done some work that you would like to submit, you need\n  to send a patch.  There are two ways to submit a patch.  First, if\n  you're using SVN and only made changes to existing SVN files you\n  can generate the patch using:\n\n      svn diff \u003e /tmp/mypatch\n\n  and attach it to the appropriate bug or enhancement request in\n  Bugzilla (https://bugzilla.gnome.org). Create a new bug if you don't\n  find one that's applicable. Please don't submit patches to either of\n  the mailing lists, as they tend to be forgotten.\n\n  If your patch adds new files, use the `-N' flag to diff between a\n  clean directory and your development directory.  E.g.\n\n  $ diff -urN {gnucash-pristine} {gnucash-mydevel} \u003e /tmp/mypatch\n\nThank you.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodinguser%2Fgnucash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodinguser%2Fgnucash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodinguser%2Fgnucash/lists"}