2016-04-14 08:29:16 +03:00
|
|
|
|
|
|
|
|
|
hledger-ui(1) hledger User Manuals hledger-ui(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NNAAMMEE
|
|
|
|
|
hledger-ui - curses-style interface for the hledger accounting tool
|
|
|
|
|
|
|
|
|
|
SSYYNNOOPPSSIISS
|
|
|
|
|
hledger-ui [OPTIONS] [QUERYARGS]
|
|
|
|
|
hledger ui -- [OPTIONS] [QUERYARGS]
|
|
|
|
|
|
|
|
|
|
DDEESSCCRRIIPPTTIIOONN
|
|
|
|
|
hledger is a cross-platform program for tracking money, time, or any
|
|
|
|
|
other commodity, using double-entry accounting and a simple, editable
|
|
|
|
|
file format. hledger is inspired by and largely compatible with
|
2016-04-18 05:28:16 +03:00
|
|
|
|
ledger(1).
|
|
|
|
|
|
|
|
|
|
hledger-ui is hledger's curses-style interface. It reads a hledger
|
|
|
|
|
journal file
|
2016-04-14 08:29:16 +03:00
|
|
|
|
|
|
|
|
|
(~/.hledger.journal, $LEDGER_FILE, or -f FILE; see hledger(1) or
|
|
|
|
|
hledger_journal(5))
|
|
|
|
|
|
|
|
|
|
and provides a simple full-screen console interface for viewing account
|
|
|
|
|
balances and transactions.
|
|
|
|
|
|
|
|
|
|
It is simpler and more convenient for browsing than the command-line
|
|
|
|
|
interface, but lighter and faster than hledger-web.
|
|
|
|
|
|
|
|
|
|
The journal file is ~/.hledger.journal, $LEDGER_FILE, or another file
|
|
|
|
|
specified with -f. For more about the format, see hledger(1) or
|
|
|
|
|
hledger_journal(5).
|
|
|
|
|
|
|
|
|
|
OOPPTTIIOONNSS
|
|
|
|
|
Note: if invoking hledger-ui as a hledger subcommand, write -- before
|
|
|
|
|
options as shown above.
|
|
|
|
|
|
|
|
|
|
Any QUERYARGS are interpreted as a hledger search query which filters
|
|
|
|
|
the data.
|
|
|
|
|
|
|
|
|
|
----ffllaatt show full account names, unindented
|
|
|
|
|
|
|
|
|
|
----nnoo--eelliiddee
|
|
|
|
|
don't compress empty parent accounts on one line
|
|
|
|
|
|
|
|
|
|
----rreeggiisstteerr==AACCCCTTRREEGGEEXX
|
|
|
|
|
start in the (first) matched account's register screen
|
|
|
|
|
|
|
|
|
|
----tthheemmee==ddeeffaauulltt||tteerrmmiinnaall||ggrreeeenntteerrmm
|
|
|
|
|
use this custom display theme
|
|
|
|
|
|
|
|
|
|
--VV ----vvaalluuee
|
|
|
|
|
show amounts as their current market value in their default val-
|
|
|
|
|
uation commodity (accounts screen only)
|
|
|
|
|
|
2016-04-19 03:00:54 +03:00
|
|
|
|
--hh show usage
|
|
|
|
|
|
2016-04-20 00:40:58 +03:00
|
|
|
|
----hheellpp show manual
|
|
|
|
|
|
|
|
|
|
----mmaann show manual with man
|
|
|
|
|
|
|
|
|
|
----iinnffoo show manual with info
|
2016-04-14 08:29:16 +03:00
|
|
|
|
|
|
|
|
|
----vveerrssiioonn
|
2016-04-20 00:40:58 +03:00
|
|
|
|
show version
|
2016-04-14 08:29:16 +03:00
|
|
|
|
|
|
|
|
|
hhlleeddggeerr ooppttiioonnss
|
|
|
|
|
The following common hledger options should also work:
|
|
|
|
|
|
|
|
|
|
--ff FFIILLEE ----ffiillee==FFIILLEE
|
|
|
|
|
use a different input file. For stdin, use -
|
|
|
|
|
|
|
|
|
|
----rruulleess--ffiillee==RRUULLEESSFFIILLEE
|
|
|
|
|
Conversion rules file to use when reading CSV (default:
|
|
|
|
|
FILE.rules)
|
|
|
|
|
|
|
|
|
|
----aalliiaass==OOLLDD==NNEEWW
|
|
|
|
|
display accounts named OLD as NEW
|
|
|
|
|
|
|
|
|
|
----iiggnnoorree--aasssseerrttiioonnss
|
|
|
|
|
ignore any failing balance assertions in the journal
|
|
|
|
|
|
|
|
|
|
----ddeebbuugg==NN
|
|
|
|
|
show debug output if N is 1-9 (default: 0)
|
|
|
|
|
|
|
|
|
|
--bb ----bbeeggiinn==DDAATTEE
|
|
|
|
|
include postings/txns on or after this date
|
|
|
|
|
|
|
|
|
|
--ee ----eenndd==DDAATTEE
|
|
|
|
|
include postings/txns before this date
|
|
|
|
|
|
|
|
|
|
--pp ----ppeerriioodd==PPEERRIIOODDEEXXPP
|
|
|
|
|
set start date, end date, and/or reporting interval all at once
|
|
|
|
|
(overrides the flags above)
|
|
|
|
|
|
2016-05-28 22:58:30 +03:00
|
|
|
|
----ddaattee22
|
|
|
|
|
show, and match with -b/-e/-p/date:, secondary dates instead
|
2016-04-14 08:29:16 +03:00
|
|
|
|
|
|
|
|
|
--CC ----cclleeaarreedd
|
|
|
|
|
include only cleared postings/txns
|
|
|
|
|
|
|
|
|
|
----ppeennddiinngg
|
|
|
|
|
include only pending postings/txns
|
|
|
|
|
|
|
|
|
|
--UU ----uunncclleeaarreedd
|
|
|
|
|
include only uncleared (and pending) postings/txns
|
|
|
|
|
|
|
|
|
|
--RR ----rreeaall
|
|
|
|
|
include only non-virtual postings
|
|
|
|
|
|
|
|
|
|
----ddeepptthh==NN
|
|
|
|
|
hide accounts/postings deeper than N
|
|
|
|
|
|
|
|
|
|
--EE ----eemmppttyy
|
|
|
|
|
show empty/zero things which are normally omitted
|
|
|
|
|
|
|
|
|
|
--BB ----ccoosstt
|
|
|
|
|
show amounts in their cost price's commodity
|
|
|
|
|
|
|
|
|
|
KKEEYYSS
|
|
|
|
|
Generally the cursor keys navigate; right (or enter) goes deeper, left
|
|
|
|
|
returns to the previous screen, up/down/page up/page down/home/end move
|
|
|
|
|
up and down through lists.
|
|
|
|
|
|
|
|
|
|
g gets the latest data and reloads the screen (and any previous
|
|
|
|
|
screens). There may be a noticeable pause.
|
|
|
|
|
|
|
|
|
|
q quits the application.
|
|
|
|
|
|
|
|
|
|
Some screens have additional key bindings, described below.
|
|
|
|
|
|
|
|
|
|
SSCCRREEEENNSS
|
|
|
|
|
AAccccoouunnttss ssccrreeeenn
|
|
|
|
|
This is normally the first screen displayed. It lists accounts and
|
|
|
|
|
their balances, like hledger's balance command. By default, it shows
|
|
|
|
|
all accounts and their latest ending balances. if you specify a query
|
|
|
|
|
on the command line, it shows just the matched accounts and the bal-
|
|
|
|
|
ances from matched transactions.
|
|
|
|
|
|
|
|
|
|
When not in flat mode, indentation indicates the account hierarchy. F
|
|
|
|
|
toggles flat mode on and off.
|
|
|
|
|
|
|
|
|
|
By default, all subaccounts are displayed. To see less detail, set a
|
|
|
|
|
depth limit by pressing a number key, 1 to 9. Or, adjust the depth
|
|
|
|
|
limit by pressing - or + (= also works). 0 removes the depth limit.
|
|
|
|
|
|
|
|
|
|
C toggles cleared mode. In cleared mode, the accounts and balances are
|
|
|
|
|
derived only from transactions which are marked cleared (*).
|
|
|
|
|
|
|
|
|
|
Press right or enter to view an account's transactions register.
|
|
|
|
|
|
|
|
|
|
RReeggiisstteerr ssccrreeeenn
|
|
|
|
|
This screen lists all transactions affecting a particular account (like
|
|
|
|
|
a check register). In cleared mode (press C) it lists only transac-
|
|
|
|
|
tions which are marked cleared. It does not otherwise filter by query.
|
|
|
|
|
|
|
|
|
|
Note this screen shows transactions, not postings (unlike hledger's
|
|
|
|
|
register command). This means:
|
|
|
|
|
|
|
|
|
|
+o Each line represents a whole transaction.
|
|
|
|
|
|
|
|
|
|
+o For each transaction, it shows the other account(s) involved, in
|
|
|
|
|
abbreviated form. (If there are both real and virtual postings, it
|
|
|
|
|
shows only the accounts affected by real postings.)
|
|
|
|
|
|
|
|
|
|
+o It shows the overall change to the current account's balance from
|
|
|
|
|
each transaction; positive for an inflow to this account, negative
|
|
|
|
|
for an outflow.
|
|
|
|
|
|
|
|
|
|
+o When no query other than a date limit is in effect, it shows the cur-
|
|
|
|
|
rent account's historic balance as of the transaction date. Other-
|
|
|
|
|
wise it shows a running total starting from zero. Eg, these will
|
|
|
|
|
show historic balances:
|
|
|
|
|
|
|
|
|
|
$ hledger-ui
|
|
|
|
|
$ hledger-ui --begin 'this month'
|
|
|
|
|
$ hledger-ui --register checking date:2015/10
|
|
|
|
|
|
|
|
|
|
while these will show a running total, since the queries are not just
|
|
|
|
|
date limits:
|
|
|
|
|
|
|
|
|
|
$ hledger-ui checking
|
|
|
|
|
$ hledger-ui --begin 'this month' desc:market
|
|
|
|
|
$ hledger-ui --register checking --cleared
|
|
|
|
|
|
|
|
|
|
Press right or enter to view the selected transaction in full detail.
|
|
|
|
|
|
|
|
|
|
TTrraannssaaccttiioonn ssccrreeeenn
|
|
|
|
|
This screen shows a single transaction, as a general journal entry,
|
|
|
|
|
similar to hledger's print command and journal format (hledger_jour-
|
|
|
|
|
nal(5)).
|
|
|
|
|
|
|
|
|
|
The transaction's date(s) and any cleared flag, transaction code,
|
|
|
|
|
description, comments, along with all of its account postings are
|
|
|
|
|
shown. Simple transactions have two postings, but there can be more
|
|
|
|
|
(or in certain cases, fewer).
|
|
|
|
|
|
|
|
|
|
up and down will step through all transactions listed in the previous
|
|
|
|
|
account register screen. In the title bar, the numbers in parentheses
|
|
|
|
|
show your position within that account register. They will vary
|
|
|
|
|
depending on which account register you came from (remember most trans-
|
|
|
|
|
actions appear in multiple account registers). The #N number preceding
|
|
|
|
|
them is the transaction's position within the complete unfiltered jour-
|
|
|
|
|
nal, which is a more stable id (at least until the next reload).
|
|
|
|
|
|
|
|
|
|
EErrrroorr ssccrreeeenn
|
|
|
|
|
This screen will appear if there is a problem, such as a parse error,
|
|
|
|
|
when you press g to reload. Once you have fixed the problem described,
|
|
|
|
|
press g again to reload and restore normal operation.
|
|
|
|
|
|
|
|
|
|
EENNVVIIRROONNMMEENNTT
|
|
|
|
|
LLEEDDGGEERR__FFIILLEE sets the default journal file path. If not set, it is
|
|
|
|
|
~/.hledger.journal.
|
|
|
|
|
|
|
|
|
|
CCOOLLUUMMNNSS sets the screen width to use (normally the full terminal
|
|
|
|
|
width).
|
|
|
|
|
|
|
|
|
|
FFIILLEESS
|
|
|
|
|
Reads data from a hledger journal file ($LEDGER_FILE or
|
|
|
|
|
~/.hledger.journal by default), or a CSV file plus associated CSV rules
|
|
|
|
|
file.
|
|
|
|
|
|
|
|
|
|
BBUUGGSS
|
|
|
|
|
The need to precede options with -- when invoked from hledger is awk-
|
|
|
|
|
ward.
|
|
|
|
|
|
|
|
|
|
-f- doesn't work (hledger-ui can't read from stdin).
|
|
|
|
|
|
|
|
|
|
-V affects only the accounts screen.
|
|
|
|
|
|
|
|
|
|
When you press g, the current and all previous screens are regenerated,
|
|
|
|
|
which may cause a noticeable pause. Also there is no visual indication
|
|
|
|
|
that this is in progress.
|
|
|
|
|
|
|
|
|
|
The register screen's switching between historic balance and running
|
|
|
|
|
total based on query arguments may be confusing, and there is no column
|
|
|
|
|
heading to indicate which is being displayed.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RREEPPOORRTTIINNGG BBUUGGSS
|
|
|
|
|
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
|
|
|
|
or hledger mail list)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
AAUUTTHHOORRSS
|
|
|
|
|
Simon Michael <simon@joyful.com> and contributors
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
CCOOPPYYRRIIGGHHTT
|
|
|
|
|
Copyright (C) 2007-2016 Simon Michael.
|
|
|
|
|
Released under GNU GPL v3 or later.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SSEEEE AALLSSOO
|
|
|
|
|
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
|
|
|
|
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
|
|
|
|
|
dot(5), ledger(1)
|
|
|
|
|
|
|
|
|
|
http://hledger.org
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2016-05-29 09:31:44 +03:00
|
|
|
|
hledger-ui 0.28 May 2016 hledger-ui(1)
|