* 1 Gnucash for OSX Quartz
o 1.1 Prerequisites:
o 1.2 Installation:
+ 1.2.1 Installing Finance::Quote
o 1.3 Documentation:
o 1.4 Known Issues:
o 1.5 OSX Revision History
+ 1.5.1 Updates in 2.4.5
+ 1.5.2 Updates in 188.8.131.52
+ 1.5.3 Updates Since 2.4.3
+ 1.5.4 Updates Since 2.4.1
+ 1.5.5 Updates Since 2.4.0
+ 1.5.6 Updates Since 2.2.9
o 1.6 License and Included Binaries:
Gnucash for OSX Quartz
Gnucash of OSX Quartz requires MacOSX 10.5 (Leopard) or MacOSX 10.6
(Snow Leopard). It will not work on 10.4 (Tiger) because some of the
libraries on which it depends now use features introduced in 10.5.
If you are upgrading from a version of Gnucash older than 2.3.9, please
run the "Update Dirs" application in the dmg. This will convert your
online banking setup to work with the new version of AqBanking and will
copy your .gnucash directory to the more Mac-appropriate
Simply drag Gnucash.app to the Applications folder (or anywhere else you
When you first open GnuCash.app, it will create a link from the bundle
Resources folder to /Library/Gnucash-2.4. It will do this automatically,
and no authentication is required if your userid has permission to
administer the computer (set in System Preferences>Accounts).
You can easily install Finance::Quote by double-clicking the
"FinanceQuote Update" applet in the dmg.
You'll need to have Developer Tools (Tiger or Leopard) or XCode (Snow
Leopard) installed. It's available as an optional install on your
Both the Gnucash Help system and the Gnucash Guide are provided in HTML
format. They will open in your default browser when you select the
appropriate item in the Help menu. Appropriate sections of help will be
similarly opened when you click on a Help button in a dialog box.
* Gnucash is not a native Mac application: It is a Gtk+ application
which has been recompiled to run on OSX. Accordingly, some features
to which Mac users are accustomed aren't supported. Some of these
are non-menu-based keyboard shortcuts (key bindings; you can adjust
them as you like in the gtkrc file), input methods, and Universal
* An instance of dbus is started by the application startup script,
but dbus isn't designed to be run that way, so it doesn't shut down
when you close the application. When Gnucash starts up again, it
will kill any instances of dbus which are running from the same
path, but if you move Gnucash.app or are switching between stable
and development versions, you may wind up with more than one
instance. You can clean out the running dbus-daemons by either
issuing "killall dbus-daemon" at a command line or by telling it to
quit from /Applications/Utilities/Activity Monitor. Note that if you
want to delete Gnucash.app, you'll need to kill the running instance
of dbus-daemon first or you'll get "file in use" errors from Finder.
* As of Gnucash 2.3.9, Gnucash's configuration files are in
$HOME/Library/Application Support/Gnucash instead of $HOME/.gnucash
so that they're visible with Finder. GConf and AQBanking still have
their configuration files in $HOME/.gconf, $HOME/.gconfd, and
$HOME/.aqbanking (Note that 2.3.8 and previous used an older version
of aqbanking which kept its config files in $HOME/.banking)
* The only libdbi module included is for SQLite. If you need either
the MySQL or Postgresql modules, you will have to build them
yourself and install them into
Gnucash.app/Contents/Resources/lib/dbd. For instructions, see
* The first time a window is opened in the Aqbanking setup wizard,
it's too small and the resize triangle is hidden. It's there, just
click on where it should be and drag the window to an appropriate
size. After you've done that once, Gnucash should remember it
* Aqbanking's chipcard facility isn't included. This may be added in
the future if we can get it to work.
* There have been two bug reports about problems with importing OFX
and MT940 data. (This is in addition to the HBCI fix noted in
"Updates in 184.108.40.206".
OSX Revision History
Updates in 2.4.5
Nothing specific to OSX. See the general release notes.
Updates in 220.127.116.11
* Fixed an omission in the bundle which caused the AQBanking setup
wizard to crash when working with HBCI users.
Updates Since 2.4.3
Gtk+ is upgraded to 2.24.1. This is the final stable series of Gtk+2,
and is necessary to prepare Gnucash to migrate to Gtk+3 in version 2.6.
Updates Since 2.4.1
Nothing specific to OSX. See the general release notes.
Updates Since 2.4.0
* Gnucash on OSX now provides Aqbanking 5 with a Gtk setup wizard.
That makes the bundle size about 1/3 smaller because we no longer
need to include the Qt frameworks.
* Better handling of the language list, so that English will work well
in any location on the list, for any variety of English. The Gtk
translations are included so that "stock" buttons will be translated.
Updates Since 2.2.9
* Gnucash.app now uses Gtk+-2.20.1, which addresses many usability
problems with earlier versions. In particular, mouse cursor
placement in the register is much better.
* AQBanking uses a new Qt4-based wizard which should be more stable
than the ported Qt3 wizard of previous releases.
* Keyboard menu accelerators and key bindings are now more mac-like.
* Cut, Copy, and Paste now work in the register pages!
* The untranslated strings in the Gnucash and Window menus have been
mostly translated, though there are a couple of languages missing
because Google Translation doesn't know them. If yours is one of
them, by all means send me a translation (UTF-16, please) and I'll
add it in.
* Printing works!
* Gnucash will now run from paths which include spaces.
* The Gnucash configuration files are now stored in
$HOME/Library/Application Support/Gnucash instead of $HOME/.gnucash.
This allows them to be seen with Finder and edited with TextEdit.
* AqBanking and Gwenhywfar are updated to far more recent versions
from the ancient versions previously included. This requires
updating any aqbanking configuration files.
* These changes require running Update Dirs.app, located in the DMG,
to migrate to this version from Gnucash 2.3.8 or Gnucash 2.2.9.
* Gnucash now installs its link in /Library so that authentication
isn't needed at first launch if your userid is allowed to administer
* There is a convenient applet provided to install/update Finance::Quote.
* Gwenhywfar plugins are now in the bundle (Thanks to Frank Beslmeisl
for pointing this out).
* Hardcoded paths to perl libraries have been removed, so
Finance::Quote installation will work even if you don't have the
same perl version installed on your system that was used for the
* Localization now follows the settings in System Preferences, with a
couple of issues thanks to Gettext.
License and Included Binaries:
Gnucash is licensed under the Gnu General Public License Version 2, a
copy of which can be found in the file LICENSE in this directory and in
each bundle's Contents folder. There is also a file "Sources" which
lists the several libraries included in the bundle upon which Gnucash
depends along with their home webpages where you may find more licensing
information and source downloads. A few of the libraries require patches
to compile on OSX; all of those patches have been submitted as bugs to
the respective libraries, but you'll find them at
http://github.com/jralls/gnucash-on-osx/patches if you're really curious.