GnuCash/sandbox

This is a "sandbox" page which is a draft version of the main page to which it is a subpage. If/when the version here is better than the main page, it can be copied in its entirety (except for this message) into the main page. Discussion should mainly take place in email lists and/or at the Talk page of the main page.

GnuCash is the leading GPL'ed Desktop Financial Manager Application. Appropriate for personal and small business use, it is meant to be easy to use and full of features.

There is no registration required to read this wiki or download and install GnuCash, only to edit this wiki.

Available Documentation

Official GnuCash Documentation

GnuCash offers two major pieces of documentation:

• The Help Manual - a quick reference manual for specific tasks, and
• The Tutorial and Concepts Guide - an in-depth guide to the concepts. It is highly recommended to read at least the first chapters of the guide.

The Documentation page on the GnuCash.org website also contains the latest, unstable, releases of the documentation, documentation for other languages, documentation for earlier releases, and documentation in PDF, ePub or mobi formats.

GnuCash Wikis

(Parts of) this wiki have been translated into other languages or contain information for one specific language only.

• The German Wiki de/GnuCash Deutsche Wiki-Seiten, im Entstehen.
• The Spanish Wiki es/GnuCash Wiki español.
• The Portugese Wiki pt/GnuCash Sítio Wiki em Português, em andamento.

The GnuCash FAQ

The GnuCash FAQ contains the collection of frequently asked questions about GnuCash, including administration, accounting, and glossary questions.

Using GnuCash

Using GnuCash collects real life experiences using GnuCash. You may find (user) solutions here that are not covered by the documentation.

The Wiki Glossary

The Wiki Glossary explains some often used terms, with additional terms useful for developers, documentation writers, and translators.

More Specific Topics

Here is a section of helpful tips on specific aspects of the use and functionality of GnuCash.

• "Normal" Usage
  • Keyboard Shortcuts
  • Using Scheduled Transactions
  • Online Banking: Setting up OFXDirectConnect in GnuCash 2 and AqBanking (FinTS/HBCI)
  • Trading Accounts (New since 2.3.8/2.4.0)
• Scripting and Programming:
  • How to create some Custom Reports
  • Python Bindings
  • Notes about the C API
  • The GnuCash API
• Error Seaching:
  • Logging messages and filtering detail.
  • Getting a Stack Trace

External Documentation Resources

These resources are one created by users of GnuCash. They may be useful.

• GnuCash Quick Start Guide For Business Users.
• Also, business users might be interested in a book by PacktPub, UK: GnuCash 2.4 Small Business Accounting, by Ashok Ramachandran
• List to external international documentation and a somewhat outdated list of available online documentation

Installation

Installation instructions for the different operating systems under which GnuCash operates are included at Installation.

Support Options

If you read the relevant parts of the pages above and are still stuck with a problem or only wish to give some feedback, you can contact us in several ways.

Current discussions

Mailing Lists

Most users will probably contact the GnuCash user community through the appropriate language user mailing list (gnucash-user, gnucash-de, gnucash-nl, gnucash-it, gnucash-es, gnucash-fr, gnucash-br). Additional information can be found at Mailing Lists.

IRC Chat

Some users may wish to use IRC chat, usually in english, as the quickest way to get answers.

External support pages

These external support sites have subsections related to GnuCash. They are not maintained by the GnuCash team, so there is no guarantee on the correctness of the information you will find here.

• Stack Exchange includes a forum on money with "gnucash" tagged questions.

Feature requests and bug tracking

• Bugzilla. GnuCash's bug database for error reports and enhancement requests.
• Uservoice Forum. For more general feature requests.

In addition, there is an old WishList on this wiki that users can consult. While this list is not maintained or monitored, users can see some of the things that have been requested in the past.

Third party tools

Several users have published tools to work with GnuCash.

Developing for GnuCash

You may want to check out the GnuCash website for the latest news.

This part of the wiki is intended to become the main repository of GnuCash developer documentation. Some formerly static pages have been moved here from the GnuCash website, but the move is not yet complete. Some remaining static pages may be out of date. Wherever a wiki article disagrees with a static web page on the Website, the wiki article here is more likely to be correct.

Getting involved in the project

The GnuCash Project is a volunteer-driven organization. We need your help to survive and grow, to help others and to help the Project. There are many ways to contribute your knowledge and experience. Contributing to GnuCash identifies a number of ways to get involved. Below are general ways.

Mailing Lists

Subscribing to the mailing lists, and asking and answering questions there, is an excellent way to begin contributing the the success of GnuCash. See Mailing Lists for more.

Filing Bugs and Enhancement Requests

Occasionally, GnuCash will not work the way it was designed to work--or you have an idea for making GnuCash better. Improvements and fixes can be submitted using the Bugzilla bug tracker; more general suggestions can be made via the [1] pages.

Developing the Documentation

• Documentation Update Instructions. This page describes the process to change both the GnuCash Tutorial and Concepts Guide and the Help Manual.
• Documentation. The Doxygen source documentation system and its wiki page.

Translating the Documentation

• Translations gives an overview of this process, but please keep an eye on the Translation Status

Developing the Application Code

Policy

• Our Development Process
• Coding Standards
• Testing

Procedures

• Git access
• Building GnuCash from source code.
• Notes about the Graphical User Interface aka GUI
• Some notes about the GnuCash XML format for the XML Backend.
• The schema for the SQL Backend.

Other Development Notes

• How to improve or add new Account Hierarchy Templates.
• Reminders for the Project Administration
• Special events
  • There was a Bounty Program in June / July 2013
  • GSoC Google Summer of Code

Future developments

• Our Release Schedule
• Future Roadmap
• A general edited list of requested enhancements: WishList
• Particular enhancements:
  • Concept Guide
  • Budgets
  • Credit Notes
• Old discussions about enhancement requests that have been implemented.
  • Upgrade from 1.8.9 to 1.8.10 and HBCI online banking support
• Discussion about the License