v1.9 (October 8th, 2018)

In this release, the click behaviour has been updated to allow filtering for payees. The entry input forms now allow inputting prices and costs. As always, bugs have been fixed.

v1.8 (July 25th, 2018)

The journal design has been updated and should now have a clearer structure. Starting with this version, there will not be any more GUI releases of Fava. The GUI broke frequently and does not seem to worth the maintenance burden.

Other changes:

  • When downloading documents, the original filename will be used.
  • any() and all() functions have been added to the filter syntax to allow filtering entries by properties of their postings.
  • As always, bugs have been fixed.

v1.7 (March 9th, 2018)

The entry filters have been reworked in this release and should now support for more flexible filtering of the entries. See the help page on how the new syntax works. Also, when completing the payee in the transaction form, the postings of the last transaction for this payee will be auto-filled.

Other changes:

  • The fava-option to hide the charts has been removed. This is now tracked in the page URL.
  • As always, bugs have been fixed.

v1.6 (November 6th, 2017)

This is a release with various small changes and mainly some speed improvements to the Balance Sheet and the net worth calculation. Also, if ‘At Value’ is selected, the current unrealized gain is shown in parentheses in the Balance Sheet.

Other changes:

  • The currently filtered entries can now be exported from the Journal page.
  • The CLI now has a --version flag.

v1.5 (July 23rd, 2017)

Fava now has an interface to edit single entries. Clicking on the entry date in the Journal will open an overlay that shows the entry context and allows editing just the lines of that entry.

Other changes:

  • The source editor now has a menu that gives access to editor commands like “fold all”.
  • Entries with matching tags or links can now be excluded with -#tag.
  • The keyboard shortcuts are now displayed in-place.
  • The incognito option has been removed and replaced with a --incognito command line switch.
  • As always, several bugs have been fixed.

v1.4 (May 14th, 2017)

Fava now provides an interface for Beancount’s import system that allows you to import transactions from your bank for example.

Fava can now show your balances at market value or convert them to a single currency if your file contains the necessary price information.

We now also provide a compiled GUI version of Fava for Linux and macOS. This version might still be a bit buggy so any feedback/help on it is very welcome.

Other changes:

  • The insert-entry option can be used to control where transactions are inserted.
  • The transaction form now accepts tags and links in the narration field.
  • Budgets are now accumulated over all children where appropriate.
  • As always, several bugs have been fixed.

Thanks to @TZdyrski and @Akuukis for their contributions.

v1.3 (March 15th, 2017)

The translations of Fava are now on, which has helped us get translations in five more languages: Chinese (simplified), Dutch, French, Portuguese, and Spanish. A big thank you to the new translators!

The transaction form has been improved, it now supports adding metadata and the suggestions will be ranked by how often and recently they occur (using exponential decay).

The Query page supports all commands of the bean-query shell and shares its history of recently used queries.

Fava has gained a basic extension mechanism. Extensions allow you to run hooks at various points, e.g., after adding a transaction. They are specified using the extensions option and for an example, see the fava.ext.auto_commit extension.

Other changes:

  • The default sort order in journals has been reversed so that the most recent entries come first.
  • The new incognito option can be used to obscure all numbers.
  • As always, several bugs have been fixed.

Thanks to @johannesharms and @xentac for their contributions.

v1.2 (December 25th, 2016)

You can now add transactions from within Fava. The form supports autocompletion for most fields.

Fava will now show a little bubble in the sidebar for the number of events in the next week. This can be configured with the upcoming-events option.

Other changes:

  • The payee filter can filter by regular expression.
  • The tag filter can filter for links, too.
  • There’s a nice spinning indicator during asynchronous page loads.
  • The Journal shows little indicators for metadata.
  • As always, several bugs have been fixed.

Thanks to @fokusov for their contributions.

v1.1 (November 19th, 2016)

You can now upload documents by dropping them onto transactions, which will also add the file path as statement metadata to the transaction. Fava also ships with a plugin to link these transactions with the generated documents. See the help pages for details.

This is the first release for which we provide compiled binaries (for macOS and Linux). These do not have any dependencies and can simply be executed from the terminal.

Other changes:

  • The bar charts on account pages now also show budgets.
  • The Journal can now be sorted by date, flag and narration.
  • Fava now has a Russian translation, thanks to @fokusov.
  • As always, several bugs have been fixed.

Thanks to @adamgibbins and @xentac for their contributions.

v1.0 (October 19th, 2016)

This is a major new release that includes too many improvements and changes to list. Some highlights:

  • The layout has been tweaked and we use some nicer fonts.
  • Fava looks and works much better on smaller screens.
  • Fava loads most pages asynchronously, so navigating Fava is much faster and responsive.

Fava’s configuration is not read from a configuration file anymore but can rather be specified using custom entries in the Beancount file. Some options have also been removed or renamed, so check Fava’s help page on the available options when upgrading from v0.3.0.

There have been many changes under the hood to improve Fava’s codebase and a lot of bugs have been squashed.

Thanks to @adamgibbins, @davidastephens, @xentac, and @yegle for their contributions.

v0.3.0 (May 24th, 2016)


  • Support for switching between multiple beancount files. #213
  • New sunburst charts. #198
  • Add “Clear filter” button when filters are active. #290
  • Simple budgeting functionality in the Account view. See help pages on how to use budgets. #294
  • German translation. #284
  • The Beancount is now being reloaded when it is saved in the Source Editor.
  • New Journal filter controls. Thanks to @yagebu.
  • Tree-tables are now displayed in a hierarchical way. Thanks to @yagebu.


  • All charts are now rendered with d3.js. Thanks to @yagebu.
  • The title of a page is now shown in the header to save screen space.
  • Changed shortcut for Journal from g g to g j as the Journal was renamed from “General Journal” to “Journal”.

New configuration options

  • language: The language to use. Valid languages are "en" and "de" (default: "en"). #284
  • treemaps-show-negative-numbers was removed.


  • Commodity prices are now filtered when a Time filter is enabled. #273
  • Some improvements to the help pages.
  • Many small bug fixes. Thanks to @yagebu.

v0.2.6 (March 20th, 2016)


  • There are now more interval options available for charts and the account balances report. The interval can be selected from a dropdown next to the charts. #175
  • Show metadata for postings in the Journal. Thanks to @corani. #185
  • The editor now supports org-mode style folding. Thanks to @corani. #209
  • Show colored dots for all the postings of a transaction in the Journal report. This way flagged postings can be quickly spotted. #195
  • Add keyboard shortcuts for save to source editor. #199


  • Use beancount’s DisplayContext to determine the correct precision at which to render numbers. #188
  • Improve the way that query results are serialized to XLS etc. Thanks to @corani. #168
  • Show inverse rates for pairs of operating currencies on the commodities report. #139
  • Use Click for the CLI and check if beancount file exists on startup. #216
  • Hide closed accounts in tree tables. Also see new configuration option below.

New configuration options

  • editor-strip-trailing-whitespace to enable trimming of trailing whitespace in the Source editor (default: “false”). Thanks to @corani. #163
  • show-closed-accounts to show closed accounts in tree tables, for example on the balance sheet (default: “false”). #91
  • show-accounts-with-zero-balance to show accounts with a balance of zero in tree tables (default: “true”). #91
  • show-accounts-with-zero-transactions to show accounts with no transactions in tree tables (default: “true”). #91


  • Fixed a bug where the months would be off by one for the interval reports. #182
  • Fix the net worth report for more than one currency. #207
  • Some improvements to the help pages.
  • Many small bug fixes.

v0.2.5 (February 28th, 2016)

Bump release to remove unused draft code.

v0.2.4 (February 28th, 2016)


  • Added missing Holdings views compared to bean-web. Thanks to @yagebu. #140
  • Custom queries are now shown in sidebar. Thanks to @corani. #135
  • The user settings file is now editable in the Source editor. #136
  • Added second theme. Thanks to Rubén Gómez for the stylesheet. #59
  • Added Help pages.
  • Query results can now be downloaded as CSV, XLS, XLSX and ODS. #143
  • Documents can now be uploaded by dragging and dropping files over an Account name on the Account page and all tree-tables. #157
  • Journal can now be filtered by transaction type. Thanks to @yagebu.


  • The uptodate-indicator is now shown everywhere by default, but only enabled for accounts that have the metadata fava-uptodate-indication: "True" set on their open-directives. #35
  • Speedier Journal rendering. Thanks to @yagebu. #164
  • Only basenames will be shown for documents in the Journal. Thanks to @corani.
  • Slightly reordered the sidebar menu.
  • Minor UI tweaks.

New configuration options

  • sidebar-show-queries: The maximum number of custom queries to show in the sidebar (default: 5).
  • theme: The theme to use. Valid themes are "default" and "alternative" (default: "default").
  • editor-print-margin-column: Set the column for the print margin in the Source editor (default: 60). #161
  • uptodate-indicator-show-everywhere (default: “true”). See Changes above.

Removed configuration options

  • uptodate-indicator-exclude-accounts, see Changes above.


  • Fixed Net worth calculation. Thanks to @yagebu.
  • Many small bug fixes.

v0.2.3 (February 15th, 2016)

Bumped version to communicate that installing via pip install now works, all requirements included. Thanks to @blais and @yagebu.

Earlier Versions

It was not possible to install any of the earlier versions only using pip, but if you used a source install prior to this point, here are the user-facing changes going back to December 19th, 2015. The first commit in the git repository was on December 4th, 2015.

v0.2.2 (February 14th, 2016)

  • Fixed to include missing dependencies and exclude unused static assets.

v0.2.1 (February 13th, 2016)

  • Bumped version due to changes in how JavaScript and CSS are handled internally. Thanks to @yagebu. #125

v0.2.0 (February 11th, 2016 - first release of fava)

  • Renamed the project from “beancount-web” to “fava”. #85

  • Moved beancount-urlscheme-command to it’s own project.

  • 2016-01-30 - Include today in the Year to Date filter. Thanks to @corani.

  • 2016-01-30 - Legs now collapse correctly in the Journal view. Thanks to @corani.

  • 2016-01-20 - New favicon. #90

  • 2016-01-18 - Display QUERY directives in a dropdown in the Custom Query view. Thanks to @corani and @yagebu for help. #96

  • 2016-01-14 - Prevent metadata keys from linewrapping

  • 2016-01-11 - Hide filters on pages where they are not used. Thanks to @corani. #97

  • 2016-01-09 - Added Windows/Cygwin-support to beancount-urlscheme. Thanks to @redstreet.:bug:92

  • 2016-01-07 - Added setting collapse-accounts to specify a list of accounts to collapse in the account hierarchy. #91

  • 2016-01-07 - Added a beancount-urlscheme-command to register the beancount://-URL -scheme on macOS (other platforms still missing, but in development). There is a new setting called use-external-editor that will, if set to True, render all links to the Source Editor as beancount://-URLs to open the files directly in the editor specified by the external-editor-cmd-setting (The URL-scheme has to be registered with beancount-urlscheme first). This also renders the Source Editor view as readonly. #92

  • 2015-12-28 - Added new setting (and feature) called editor-insert-marker. If present, the Source editor will jump to the specified marker in the file and will insert two newlines above it and set the cursor there. #76

  • 2015-12-28 - Bar chart bars are now clickable and will set the time filter to the year and month the bar is representing.

  • 2015-12-28 - Line charts are now zoomable by drawing a rectangle with the mouse on the chart, which will then zoom to the specified area.

  • 2015-12-28 - Added keyboard shortcuts for jumping to menu items, open and focus filters, Journal entry types and more. Press ? to display an overview of all keyboard shortcuts. Thanks to @redstreet for the suggestions. #65

  • 2015-12-27 - Source editor now supports auto-completion of accounts, commodities, directives and tags.

  • 2015-12-25 - Entries can now be filtered for “No payee” Thanks to @yagebu. #42

  • 2015-12-24 - Metadata is now displayed for Journal entries. For transactions, if there is a metadata-entry called “statement” and it’s value is a path to a file (relative to the beancount-file or absolute), this file will be liked.

  • 2015-12-23 - Up-to-date indicator will be shown for Assets and Liabilities accounts in the Statistics view that indicates (there are various settings to change the behaviour of these indicators:

    green:  The latest posting is a balance check that passed.
    red:    The latest posting is a balance check that failed.
    yellow: The latest posting is not a balance check.
    gray:   The account hasn't been updated in a while.
  • 2015-12-23 - New settings to show Journal legs by default, to show different entry types in a Journal by default, to hide charts by default and to show negative numbers in treemaps

  • 2015-12-23 - Added new command line option “–settings” to specify a settings-file for beancount-web, like which entry types to display in a Journal by default. There is a sample file called “default-settings.conf” in the source that lists all possible settings.

  • 2015-12-23 - Filters are now part of every URL, so every URL is a permalink to the view including all currently set filters. Thanks to @yagebu. #54

  • 2015-12-21 - BQL queries (like with bean-query) can now be run in a new Query view. The results will be displayed as a table and somewhat formatted, as account names will be linked to the Account view for example.

  • 2015-12-20 - Simple tables are now sortable by clicking on the column headers. #46

  • 2015-12-20 - Added a yearly balances table to the Account-view. Thanks to @davidastephens.

  • 2015-12-20 - Show at most 25 x-axis-labels for bar charts. #45

  • 2015-12-20 - Fixed a minor bug where treemaps would show white areas. #49

  • 2015-12-20 - Fixed daterange filtering of entries. Thanks to @yagebu.

  • 2015-12-20 - Fixed values in Balance sheet to correctly calculate the closing balances. #19