MacOSX/2.2.9/Readme

From GnuCash
Jump to: navigation, search

Gnucash OSX

Prerequisites:

These builds for Intel X86 or PPC based Macs requires MacOSX 10.4 (Tiger), MacOSX 10.5 (Leopard), or MacOSX 10.6 (Snow Leopard)

Tiger users will need to install CUPS V1.2.12.


Installation:

Simply drag Gnucash.app to the Applications folder (or anywhere else you like -- but avoid folders with spaces in the name).

When you first open GnuCash.app, it will create a link from the bundle Resources folder to /opt/gnucash-2.2.9, and it will need an admin authorization to do so, so it will pop up a username/password dialog box. Note that it will say that "osascript requires that you type your password", not anything about Gnucash. If you subsequently move the bundle, it will relink, again requiring an admin username/password.

Installing Finance::Quote

You can easily install Finance::Quote by running $ sudo /Path/to/Gnucash.app/Contents/Resources/bin/gnc-fq-update

You'll need to have Developer Tools (Tiger or Leopard) or XCode (Snow Leopard) installed. It's available as an optional install on your installation DVD.

Documentation

Gnucash Help and the Gnucash Guide are included in the application bundle. Open Gnucash.app/Contents/Resources/English.lproj/GnuCash Help/help.html or Gnucash.app/Contents/Resources/English.lproj/GnuCash Guide/index.html in your browser.

Known Issues:

  • 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 quitting from the Dock icon, non-menu-based keyboard shortcuts (accelerator keys), and Universal Access.
  • Copying to the clipboard doesn't work in register pages; i.e., if you put a number in the wrong column and you want to cut it and paste it into a different one, it will cut fine but won't paste. Text selection in register cells is also a bit troublesome.
  • The Gnucash menu is a bit weird when using multiple windows: The Quit menu is tied to the first window opened and a separate About and Preferences menu item is added for each window. If you close the first window, Quit will no longer work. You still quit by closing all windows.
  • Neither context help nor the help menu selections work.
  • 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. There's also no way at present for a new run of Gnucash to find already-running instances of dbus. This doesn't cause any real problems, but it is a resource leak. You can periodically 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.
  • The conversion of Macintosh default locale to Gtk+ is a bit primitive, and while the gnucash translation files are included, you may encounter messages from other libraries which aren't translated.
  • Some users have reported menus in the wrong language (usually Japanese). This is caused by gnucash not being able to retrieve the correct default language from OSX. It can be fixed by opening System Prefrences>International (or Language & Text on Snow Leopard) and changing something, then changing it back. It doesn't really matter what you change.
  • The placement of dialog boxes which are displayed before the main window is a bit strange. The "Tip of the Day" dialog box will appear behind and a bit offset from the splash screen, and will be warped off the screen when the main window opens. The "Since last run" dialog box, used by Scheduled Transactions, will display in the center of the screen and then be hidden behind the main window. Use Exposé to find it.
  • Note that Gnucash demands a few things that Finance::Quote doesn't in order to get quotes. Run the perl program Gnucash.app/Contents/Resources/bin/gnc-fq-check to diagnose any quote problems, and Gnucash.app/Contents/Resources/bin/gnc-fq-update (with sudo) to easily set up the required perl modules.
  • Gnucash can't see the Mac's installed printers, probably because they're not registered with Gnome. To print, use the "Preview" button on the print dialog, which will open Preview.app with a PDF of your output. You can print from there.

Fixed in 2.2.9.5 (Intel):

  • Added some missing Gwenhywfar and AQBanking plugins which prevented online banking from working correctly.

Fixed in 2.2.9.4 (PPC):

  • Gtk+ was incorrectly linked, causing Gnucash to crash on launch.
  • The Gwenhywfar plugins are now included in the bundle so that HCBI configuration will work.
  • /etc/fonts is included, which should resolve some font issues if a gtkrc file is used.
  • Updated versions of Glib and Gtk+ are linked, which resolves some of the display weirdness.

Fixed in 2.2.9.4 (Intel):

  • A crash which occurred when saving a new scheduled transaction.

Fixed in 2.2.9.3:

  • A crash that occurred when typing into the save file dialog, reported by flexbravo96 at gmail.com

2.2.9.2 is different from 2.2.9.1 only in that it was built with debugging turned off to make a smaller download. If you already have 2.2.9.1 there is no reason to download 2.2.9.2.

Fixed in 2.2.9.1:

  • Aqbanking's setup wizard now works. Thanks to Christian Stimming for walking me through the steps needed to get this to build with a recent Qt installation. The required Qt frameworks are in the bundle, so there's no need to download anything extra.
  • The intel build was built for Leopard only. Thanks to Bryce Pool for debugging this.
  • Charts (e.g. Income Barchart) didn't display because some plugins were left out of the bundle. (Thanks to Guillaume Lessard).
  • The translation files are now in the bundle. Thanks to Antoine Schweitzer-Chaput for noticing.
  • The launch script has been improved to fully set the localization variables from the Mac's localization defaults. (Thanks to Guillaume Lessard).
  • The launch script now looks for a ~/.gnucashrc, the contents of which will supplement (or override, depending upon how you write it) the environment variables passed to gnucash. (Thanks to Guillaume Lessard).

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.