LinuxCommandLibrary

gnucash

Manage personal and small-business financial accounting

TLDR

Launch GnuCash and load the previously opened file

$ gnucash
copy

Launch GnuCash and load the specified file
$ gnucash [path/to/file.gnucash]
copy

Launch GnuCash and load an empty file
$ gnucash --nofile
copy

SYNOPSIS

`gnucash` [`OPTIONS`] [`FILE`...]

Common invocation: `gnucash` `my_finances.gnucash`

For advanced operations: `gnucash` [`--add-account account_name`] [`--set-value value`] [`--import file`] [`--export file`] [`--update-prices`] [`--update-currency-exchange-rates`] [`--version`] [`--help`]

PARAMETERS

`FILE`...
    Opens one or more GnuCash data files. If no file is specified, GnuCash typically opens the last used file or presents a new file dialog.

`-h`, `--help`
    Displays a help message with command-line options and exits.

`-v`, `--version`
    Displays the GnuCash version information and exits.

`--add-account` `ACCOUNT_NAME`
    Launches GnuCash and attempts to add a new account with the specified name. This option is primarily intended for scripting or automated tasks.

`--set-value` `VALUE`
    Used in conjunction with other options (e.g., `--add-account`) to set an initial value. This is part of GnuCash's scripting interface.

`--import` `FILE`
    Imports financial data from the specified file. GnuCash supports various import formats such as QIF, OFX, and CSV.

`--export` `FILE`
    Exports GnuCash data to the specified file. This is generally for advanced or programmatic use, as most export functions are managed within the GUI.

`--update-prices`
    Connects to online sources to update stock and mutual fund prices for securities configured in your GnuCash accounts.

`--update-currency-exchange-rates`
    Connects to online sources to update currency exchange rates for all configured currencies.

DESCRIPTION

GnuCash is free and open-source accounting software that helps users manage their finances, track bank accounts, stocks, income, and expenses. It's designed to be easy to use yet powerful, employing professional accounting principles like double-entry bookkeeping. GnuCash can import financial data, generate reports, and schedule transactions, making it suitable for both personal finance management and small business accounting. Its cross-platform nature and robust features make it a popular alternative to commercial financial software.

The `gnucash` command typically launches the graphical user interface (GUI) of the application, allowing users to interact with their financial data through a rich graphical interface. While primarily a GUI application, it supports command-line arguments for opening specific files, importing data, or triggering updates.

CAVEATS

`gnucash` is primarily a graphical application; most of its functionality is accessed through its GUI. The command-line options are mainly for launching the application, opening specific files, or triggering automated updates (like prices/rates).

For advanced scripting or unattended operations, direct command-line interaction can be complex and may require a deep understanding of GnuCash's internal mechanisms or the use of companion tools or scripts designed for automation.

<B><U>DATA STORAGE</U></B>

GnuCash typically stores its financial data in an XML-based format (compressed `.gnucash` files) by default. For more robust data management, especially for larger files or in environments where database features are desired, GnuCash can be configured to use SQLite3, PostgreSQL, or MySQL databases.

<B><U>DOUBLE-ENTRY BOOKKEEPING</U></B>

A core principle of GnuCash is its strict adherence to double-entry bookkeeping. Every transaction involves at least two accounts – a source and a destination – ensuring that your books always balance. This fundamental accounting method provides a robust and accurate financial record, making GnuCash suitable for professional accounting needs.

<B><U>ONLINE SERVICES INTEGRATION</U></B>

GnuCash can connect to various online services to fetch current stock and mutual fund prices, as well as up-to-date currency exchange rates. This feature enhances the accuracy of portfolio tracking and multi-currency accounting. These updates can be triggered directly from the command line using options like `--update-prices` and `--update-currency-exchange-rates`.

HISTORY

GnuCash development began in 1997, with its first stable release in 1998. It was conceived as an open-source alternative to commercial financial software like Intuit's Quicken. From its inception, GnuCash has emphasized adherence to professional accounting principles, notably double-entry bookkeeping, distinguishing it from simpler personal finance managers.

Over the years, it has continuously evolved, adding features such as stock/mutual fund tracking, QIF/OFX/CSV import, HBCI support, scheduled transactions, and a robust reporting engine. Its commitment to free software principles and robust financial management has fostered a dedicated community and ensured its ongoing development and widespread usage on Linux, macOS, and Windows.

SEE ALSO

ledger(1), hledger(1), homebank(1)

Copied to clipboard