Easy workflow #2: hledger-web¶
hledger-web is hledger’s web browser-based UI. It’s probably the easiest way to get started with hledger. Eg on windows, you can download and unpack hledger.zip and double click on hledger-web.exe. Screenshots below!
Check your installation¶
$ hledger-web --version hledger-web 1.17.1
If this fails, check download/install for install and setup tips.
Normally, you start hledger-web by running
hledger-web in a
terminal, with no arguments. Browsing to the executable file and
double-clicking on it can also work.
Normally, this will start the web app, making it accessible only from your local machine.
For this tutorial, to follow the steps/screenshots below and avoid disturbing any existing data, we’ll start hledger-web with a new temporary journal file:
$ mkdir tmp $ echo > tmp/.hledger.journal $ hledger-web -f tmp/.hledger.journal
It will print a startup message and keep running, logging any web requests received:
22/Mar/2020:17:34:19 -0700 [Info#yesod-core] Application launched @(yesod-core-220.127.116.11-1LbNd7zV6uz551mHDWJO3b:Yesod.Core.Dispatch src/Yesod/Core/Dispatch.hs:163:11) Serving web UI and API on 127.0.0.1:5000 with base url http://127.0.0.1:5000 This server will exit after 2m with no browser windows open (or press ctrl-c) Opening web browser... 127.0.0.1 - - [22/Mar/2020:17:34:21 -0700] "GET / HTTP/1.1" 303 0 "" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:74.0) Gecko/20100101 Firefox/74.0" 127.0.0.1 - - [22/Mar/2020:17:34:21 -0700] "GET /journal HTTP/1.1" 200 - "" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:74.0) Gecko/20100101 Firefox/74.0" 127.0.0.1 - - [22/Mar/2020:17:34:23 -0700] "GET /static/js/typeahead.bundle.min.js HTTP/1.1" 200 - "http://127.0.0.1:5000/journal" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:74.0) Gecko/20100101 Firefox/74.0" ...
You can leave this terminal in the background, or minimised, but don’t quit it (unless you want the web app to quit).
And, your web browser should open, showing the UI. If not, open it yourself and browse to the url shown, ie http://127.0.0.1:5000 (and let us know).
A quick tour¶
Here’s the “home” screen, showing the empty default journal. Or if your journal already contained transactions, you’ll see them listed. “General Journal” means the list of transactions, basically.
Let’s hide the sidebar, for a simpler UI. Pressing the
s key should do it
(if not, try again after clicking somewhere on the page, and let us know):
We’ll copy the sample transactions from the quick start.
TAB to advance to each next field.
Amount2 can be left blank, or you can fill in
$-1234 if you prefer:
Let’s try filtering these transactions with a query.
food in the search field and press
Now we see just the transaction involving a
x button or click
Journal or press
j to see all data again.
You can see quick help by pressing
?, or clicking the
? button near the search field.
More help is available in the hledger-web and other manuals, of course:
That’s mostly it! Although there are basically just two screens, with hledger’s full query language available (and with the general flags available on the command line), you can do a surprising amount with hledger-web. You can also change permissions to enable edit/upload/download access.