Skip to content
GnuCash Double-Entry Accounting Program.
C C++ Scheme JavaScript Python CMake Other
Branch: maint
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bindings Fix test failure for timezones west of the prime meridian. May 2, 2020
borrowed CMake - remove parameter repetition in else() and endif() statements … Feb 6, 2020
cmake Tweak appdata file generation some more Feb 17, 2020
common Respect the environment LD_LIBRARY_PATH for loading Scheme modules an… Apr 30, 2020
contrib Housekeeping - replace plenty of http links with https Jun 6, 2019
data L10N:de_CH: Ein weiterer Tippfehler im Kontenrahmen KMU May 5, 2020
doc Remove obsolete documentation files. May 26, 2020
gnucash HIG, I18N: Improve Budget menu entries and tooltips May 27, 2020
libgnucash Fix test failure for timezones west of the prime meridian. May 2, 2020
po L10N🇩🇪 "Für" klein in "Ergebnisrechnung für Periode" etc. May 5, 2020
test-templates
util Travis - don't try to copy the removed afterfailure file to the test … Feb 29, 2020
.gitattributes Add CMake files and .gitattributes to lf-only files. Jul 13, 2017
.gitignore .gitignore housekeeping Apr 26, 2019
.travis.yml Remove the deprecated sudo tag from .travis.yml Aug 1, 2019
AUTHORS Housekeeping - replace plenty of http links with https Jun 6, 2019
CMakeLists.txt Fix LIBDBI_DRIVERS_DIR generation. May 7, 2020
ChangeLog.1999 Finish split of ChangeLog Dec 31, 2015
ChangeLog.2000 Finish split of ChangeLog Dec 31, 2015
ChangeLog.2001 Split top-level ChangeLog by year. Everything before Nov 16, 2005
ChangeLog.2002 Split top-level ChangeLog by year. Everything before Nov 16, 2005
ChangeLog.2003 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2004 Fix old Changelogs from HEAD/gnome2 parallelity; entries are now in c… Jan 28, 2006
ChangeLog.2005 ChangeLog entries from svn for past 12 days. Jan 13, 2006
ChangeLog.2006 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2006-manual Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2007 Add ChangeLog.2007 Jan 2, 2008
ChangeLog.2008 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2009 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2010 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2011 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2012 Bug 796820 - References to 'Gnome Bugzilla' should be changed to 'Gnu… Sep 28, 2018
ChangeLog.2013 Release 2.6.1 Jan 26, 2014
ChangeLog.2014 Bump Version to 2.6.6 for release. Mar 27, 2015
ChangeLog.2015 Update copyright and ChangeLog for the new year. Jan 10, 2016
ChangeLog.2016 Release 2.6.16 Mar 26, 2017
ChangeLog.2017 Merge branch 'maint' into unstable Apr 1, 2018
ChangeLog.2018 Release GnuCash 3.6 Jun 29, 2019
ChangeLog.2019 ChangeLog.2019 Mar 28, 2020
DOCUMENTERS Fix a couple of typos in DOCUMENTERS. Sep 8, 2019
HACKING Fix typos for gnuchash/ doc/ bindings/ and misc. Sep 14, 2019
LICENSE Clarify Derek's code to be licensed "GPL v2 or later" as he has confi… Sep 4, 2010
Makefile.TAGS only conditionally remove the file. May 28, 2006
NEWS Release GnuCash 3.10 Apr 11, 2020
README Redo of commit 586cd70 Sep 18, 2018
README.dependencies Add a warning for gettext < 0.20 Jan 31, 2020
README.git Housekeeping - replace plenty of http links with https Jun 6, 2019

README

############################################################
          GnuCash 3.x README file.

The current stable series is GnuCash 3.x.
------------------------------------------------------------

##################
Table of Contents:
------------------

  - Overview
  - Dependencies
  - Invocation/running
  - Internationalization
  - Building & Installing
  - Supported Platforms
  - Additional Download Sites
  - Getting the Source via Git
  - Developing GnuCash

########
Overview
--------

GnuCash is a personal and small business double entry accounting application.

Home Page:
https://www.gnucash.org/

Wiki:
https://wiki.gnucash.org/wiki/GnuCash

Precompiled binaries:
https://www.gnucash.org/download

############
Dependencies
------------

The following packages are required to be installed to run GnuCash:

[see README.dependencies]

The optional online stock and currency price retrieval feature requires Perl.
This is generally already installed on Gnu/Linux and *BSD, and MacOS.

In addition, some perl modules need to be installed. You can run the
script 'gnc-fq-update' as root to obtain the latest versions of
required packages.

Microsoft Windows users can use the "Install Online Quotes" program in the
Start menu's Gnucash group; it will install perl and all of the required
modules more-or-less automatically. MacOS users will find "Update Finance Quote"
in the distribution disk image; it will automate running gnc-fq-update for you.

#######
Running
-------

For GnuCash invocation details, see the manpage in doc/gnucash.1.
You can also run gnucash --help for the command line options.

You can start GnuCash at the command-line, with "gnucash" or "gnucash
<filename>", where <filename> is a GnuCash account file.  Sample
accounts can be found in the "doc/examples" subdirectory.  *.gnucash
files are GnuCash accounts that can be opened with the "Open File" menu entry.
*.qif files are Quicken Import Format files that can be opened with the
"Import QIF" menu entry.

GnuCash responds to the following environment variables:

  GNC_BOOTSTRAP_SCM - the location of the initial bootstrapping scheme code.

  GUILE_LOAD_PATH - an override for the GnuCash load path, used when
  loading scheme files.  It should be a string in the same form as the
  PATH or LD_LIBRARY_PATH environment variable.

  GNC_MODULE_PATH - an override for the GnuCash load path, used when
  loading gnucash modules.  It should be a string representing a
  proper scheme list.  It should be a string in the same form as the
  PATH or LD_LIBRARY_PATH environment variable.

  GNC_DEBUG - enable debugging output.  This allows you to turn on
  debugging earlier in the startup process than you can with --debug.


####################
Internationalization
--------------------

Message catalogs exist for many different languages. In general
GnuCash will use the locale configured in the desktop environment if
we have a translation for it, but this may be overridden if one
likes. Instructions for overriding the locale settings may be found at
https://wiki.gnucash.org/wiki/Locale_Settings

#####################
Building & Installing
---------------------

GnuCash uses CMake to handle the build process. Details are available
in cmake/README_CMAKE.txt

Prior to building GnuCash, you will have to obtain and install the
following packages:

  cmake: Available https://cmake.org.

  ninja: Optional, available at https://ninja-build.org. CMake can
    generated build rules for Ninja, and generally using Ninja results
    in faster builds that Makefile based ones.

  gnome development system: headers, libraries, etc.

  libxml2: available from ftp.gnome.org

  SWIG: 2.0.10 or later is needed. See http://www.swig.org or
    https://sourceforge.net/projects/swig/

Generally, up-to-date build instructions for various Linux
distributions can be found on the GnuCash wiki at
https://wiki.gnucash.org/wiki/Building

The options that the CMake build system understands are documented in
cmake/README_CMAKE.txt and in the Building wiki page mentioned above.

Note that while you need the Gnome libraries installed, you don't need
to have a Gnome desktop.

Runtime and install destinations are separate.  The CMake option
CMAKE_INSTALL_PREFIX determines where the resulting binary will look
for things at runtime.  Normally this determines where a "make
install" will put all the files.  However, cmake also supports the
DESTDIR variable.  DESTDIR is used during the `make install' step to
relocate install objects into a staging area.  Each object and path is
prefixed with the value of `DESTDIR' before being copied into the
install area.  Here is an example of typical DESTDIR usage:

     make DESTDIR=/tmp/staging install

This places install objects in a directory tree built under
`/tmp/staging'.  If `/gnu/bin/foo' and `/gnu/share/aclocal/foo.m4' are
to be installed, the above command would install
`/tmp/staging/gnu/bin/foo' and
`/tmp/staging/gnu/share/aclocal/foo.m4'.

DESTDIR can be helpful when trying to build install images and
packages.

NOTE: If you have installed different parts of Gnome in different
places (for instance, if you've installed webkit in /usr/local) you
will need to set the environment variables GNOME_PATH and
GNOME_LIBCONFIG_PATH.  See the manpage for gnome-config for more
details.


###################
Supported Platforms
-------------------

GnuCash 3.x is known to work with the following operating systems:

GNU/Linux             -- x86, Sparc, PPC
FreeBSD               -- x86
OpenBSD               -- x86
MacOS		      -- Intel, Versions 10.9 and later


GnuCash can probably be made to work on any platform for which Gtk+ can
and for which there is a C++11 compiler available, given sufficient expertise
and effort. If you try and encounter difficulty, please subscribe to the
developer's mailing list, gnucash-devel@gnucash.org and we'll try to help you.

#########################
Downloads
-------------------------

GnuCash sources and Mac and Windows binaries are hosted at
SourceForge and Github. Links for the current version are provided at
https://www.gnucash.org. We depend upon distribution packagers for
GNU/Linux and *BSD binaries, so if you want a more recent version than
your distribution provides you'll have to build from source.

##############################
Getting Source with Git
------------------------------

We maintain a mirror of our master repository on Github. You can
browse the code at https://github.com/Gnucash/gnucash. Clone URIs are
on that page, or if you have a Github account you can fork it
there.

##################
Developing GnuCash
------------------
Before you start developing GnuCash, you should do the following:

1. Read https://wiki.gnucash.org/wiki/Development

2. Look over the doxygen-generated documentation at
    https://code.gnucash.org/docs/MASTER/ or
    https://code.gnucash.org/docs/MAINT/

3. Go to the GnuCash website and skim the archives of the GnuCash
   development mailing list.

4. Join the GnuCash development mailing list. See the GnuCash website
   for details on how to do this.

5. Build the branch you want from a git clone of our repository and make
   sure that your build passes all of the tests and runs correctly.

Submitting a Patch:

  Please read https://wiki.gnucash.org/wiki/Development#Submitting_Patches.

Thank you.
You can’t perform that action at this time.