2018-04-28 21:50:14 +03:00
---
title: home
...
< style >
.highslide img {max-width:200px; float:right; margin:0 0 1em 1em;}
.highslide-caption {color:white; background-color:black;}
a {white-space:nowrap;}
< / style >
2018-04-28 23:35:12 +03:00
<!-- INTRO -->
2018-07-31 17:16:48 +03:00
< img src = "images/coins2-248.png" width = "" height = "200" style = "float:right; margin:1em 1em 0 1em;" / >
2018-04-28 21:50:14 +03:00
< h1 style = "/*font-size:4em;*/ " > hledger< / h1 >
< span style = "font-size:xx-large;" >
2019-01-20 04:39:54 +03:00
Robust plain text accounting.
<!-- Friendly, robust plain text accounting. -->
2018-04-28 21:50:14 +03:00
<!-- Robust, powerful, plain text accounting. -->
<!-- Robust, precise, plain text accounting. -->
<!-- Plain text accounting for everyone. -->
<!-- Making accounting fun for techies. -->
< / span >
2019-03-12 14:53:58 +03:00
< span style = "font-size:x-large;" > hledger< / span >
2019-03-27 23:00:37 +03:00
is an elegant, versatile accounting program, for tracking money, time, or other commodities
2019-03-15 03:47:29 +03:00
using plain text records.
2019-03-12 14:53:58 +03:00
It is a fast, dependable, secure alternative to Quicken, Xero, GnuCash etc.,
<!-- with simple yet powerful functionality, -->
accessible from command line, terminal or web browser.
Compared to other plain text accounting tools, it is more robust and intuitive.
Good docs and real world usefulness are a top priority.
2019-03-15 03:47:29 +03:00
hledger is cross platform GNU GPLv3 free software, written in Haskell.
The project is led by Simon Michael, with 100+ contributors.
I've been building and relying on hledger since 2007;
I hope you too will find it helpful in mastering your time and money.
Let us know!
2018-04-28 23:35:12 +03:00
<!-- DOCS -->
2017-04-28 17:39:19 +03:00
2015-05-26 04:15:02 +03:00
< style >
2018-04-28 21:46:42 +03:00
h2 { font-size:x-large; margin-top:.5em; }
h3 { font-size:large; margin-bottom:.2em; }
tr { border-top:thin solid #bbb ; border-bottom:thin solid #bbb ; vertical-align:top; }
td:nth-child(1) { padding-right:1em; white-space:nowrap; }
.col-sm-3, .col-sm-4 {
padding:0;
}
.contentbox {
2018-04-28 21:50:14 +03:00
margin:1em .5em .5em 0;
2018-04-28 21:46:42 +03:00
padding:.1em .5em;
border-radius:1em;
}
#introduction {
2018-04-28 21:50:14 +03:00
/* background-color:#ffb; */
2018-04-28 21:46:42 +03:00
}
#help {
background-color:#fdd;
}
#reference {
background-color:#eef;
text-align:left;
}
#reference .subcontent {
margin-left:1em;
}
2019-01-20 04:08:56 +03:00
#dev {
background-color:#eee;
text-align:left;
}
#dev .subcontent {
margin-left:1em;
}
2018-04-28 21:46:42 +03:00
#wiki {
background-color:#efe;
text-align:center;
}
#wiki .subcontent {
}
2016-04-29 11:35:30 +03:00
< / style >
2015-11-07 22:27:00 +03:00
2019-03-12 14:09:38 +03:00
< div class = "row" style = "text-align:center; " >
**[< button type = "button" class = "btn btn-default btn-success" title = "All the ways to install hledger. Get it now!" > Install hledger< / button > ](download.html)**
[<button type="button" class="btn btn-default" style="border:none; min-width:102;" title="hledger on Github. Star us!"><img src="https://img.shields.io/github/stars/simonmichael/hledger.svg?style=for-the-badge&logo=GitHub&label=Github&color=lightgrey"></button> ](https://github.com/simonmichael/hledger/ )
<!-- -->
<!-- [![... ](https://api.travis-ci.org/simonmichael/hledger.svg?branch=master )](https://travis-ci.org/simonmichael/hledger/builds){title="Travis"} -->
<!-- -->
<!-- [![... ](https://ci.appveyor.com/api/projects/status/5vejw0w5n5igdr42?svg=true )](https://ci.appveyor.com/project/simonmichael/hledger/history){title="Appveyor"} -->
< / div >
2018-04-28 21:46:42 +03:00
< div class = "container" >
< div class = "row" >
< div class = "col-sm-3" >
2014-12-11 22:45:01 +03:00
2018-04-28 21:46:42 +03:00
< div id = introduction class = contentbox >
## Introduction
2014-11-12 01:55:23 +03:00
2019-03-12 14:10:45 +03:00
**[What is hledger ?](intro.html)**\
2019-03-12 14:53:58 +03:00
More about hledger's features.
2014-11-12 01:55:23 +03:00
2019-03-12 14:10:45 +03:00
**[accounting?](Accounting-links.html)**\
2018-04-28 21:46:42 +03:00
Tracking your use of valuable commodities, such as money or time, for increased awareness and effectiveness.\
2019-03-12 15:05:16 +03:00
**[plain text accounting?](http://plaintextaccounting.org)** → \
Using plain text data formats and version control for reliable, transparent accounting.\
2018-04-28 21:46:42 +03:00
< / div >
2015-11-08 23:24:22 +03:00
2018-04-28 21:46:42 +03:00
< div id = help class = contentbox >
## Help/Feedback
|
|-------------------|----------------------------------------------------------------------------|
2019-03-12 14:10:45 +03:00
| IRC: | < small > [#hledger](http://irc.hledger.org) on Freenode <!-- [chat log ](http://ircbrowse.net/browse/hledger ); --> <!-- see also [#ledger ](http://webchat.freenode.net?channels=ledger&randomnick=1 ) --> <!-- *Quick help and background chat.* --> <!-- *If you don't get an answer promptly, you can type `sm` to alert me, or leave the window open and check back later.* --> </ small >
| Twitter: | < small > [#hledger,< br > #plaintextaccounting](#twitter)< / small >
| Reddit: | < small > [/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/)< / small >
| Hacker News: | < small > [stories](https://hn.algolia.com/?query=hledger& sort=byDate& prefix& page=0& dateRange=all& type=story), [comments ](https://hn.algolia.com/?query=hledger&sort=byDate&prefix=false&page=0&dateRange=all&type=comment )</ small >
| Mail list: | < small > [list.hledger.org](http://list.hledger.org), [hledger@googlegroups.com ](mailto:hledger@googlegroups.com )</ small >
| Issues: | < small > [bugs.hledger.org](http://bugs.hledger.org) (bugs), [issues.hledger.org ](http://issues.hledger.org ) (all), [open issues ](CONTRIBUTING.html#open-issues ) (overview)</ small >
| Other: | < small > [simon@joyful.com](mailto:simon@joyful.com)< / small >
2018-04-28 21:46:42 +03:00
< / div > <!-- column -->
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
< / div >
< div class = "col-sm-3" >
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
< div id = reference class = contentbox >
## Reference
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
**[Release notes](release-notes.html)**\
What's new in each hledger version.
2015-11-07 20:15:23 +03:00
2018-04-28 21:46:42 +03:00
**[User manual](manual.html)**\
The main hledger manuals combined on one page for easy searching.
Includes:
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
< div class = subcontent >
[hledger ](hledger.html )\
the command-line UI
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
[hledger-ui ](hledger-ui.html )\
a curses-style UI
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
[hledger-web ](hledger-web.html )\
a web UI
2014-11-12 01:55:23 +03:00
2018-04-28 21:46:42 +03:00
[hledger-api ](hledger-api.html )\
a HTTP JSON server
2014-11-12 01:55:23 +03:00
2018-04-28 21:46:42 +03:00
[journal format ](journal.html )\
hledger's native file format
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
[csv format ](csv.html )\
hledger's CSV import system
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
[timeclock format ](timeclock.html )\
a file format for precise time logging
2016-02-21 23:39:32 +03:00
2018-04-28 21:46:42 +03:00
[timedot format ](timedot.html )\
a file format for human-friendly approximate time logging
< / div >
2015-11-07 20:15:23 +03:00
< / div >
2019-01-20 04:08:56 +03:00
< div id = dev class = contentbox >
## Contribute
2019-01-20 04:31:25 +03:00
**[Contributor Guide](CONTRIBUTING.html)**\
2019-02-06 21:07:04 +03:00
What's to do and how to do it
**Help fund hledger!**\
2019-02-10 06:23:39 +03:00
Making good software and documentation costs a lot.
2019-02-06 21:07:04 +03:00
< a href = "https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5J33NLXYXCYAY" > < img width = 62 height = 31 border = 0 src = "https://www.paypal.com/en_US/i/btn/x-click-but04.gif" title = "Give one time or recurringly with Paypal" alt = "paypal" > < / a >
< a href = "https://opencollective.com/hledger#support" > < img border = "0" src = "https://opencollective.com/hledger/backers/badge.svg" title = "Back us with a monthly donation at Open Collective" alt = "open collective backers" > < / a >
< a href = "https://opencollective.com/hledger#support" > < img border = "0" src = "https://opencollective.com/hledger/sponsors/badge.svg" title = "Sponsor us with a $100+ monthly donation at Open Collective and get your organization's logo on our README" alt = "open collective sponsors" > < / a >
\
< a href = "https://www.bountysource.com/trackers/536505-simonmichael-hledger" > < img border = 0 src = "https://www.bountysource.com/badge/tracker?tracker_id=536505" title = "Contribute or claim issue bounties via Bountysource" alt = "bountysource" > < / a >
<!-- <a href="https://flattr.com/submit/auto?user_id=simonmichael&url=http%3A%2F%2Fhledger.org" target="_blank"><img border="0" src="//api.flattr.com/button/flattr - badge - large.png" alt="" title="Give monthly with Flattr" alt="flattr"></a> -->
2019-01-20 04:08:56 +03:00
< / div >
2018-04-28 21:46:42 +03:00
< / div > <!-- column -->
< div class = "col-sm-4" >
2015-05-26 04:15:02 +03:00
2018-04-28 21:46:42 +03:00
< div id = wiki class = contentbox >
< div class = subcontent >
<!-- WIKICONTENT -->
2019-02-10 06:23:39 +03:00
## [[Cookbook|Home]]
2019-01-20 03:49:36 +03:00
### Getting started
2019-02-10 06:23:39 +03:00
[[hledger basics tutorial]]
[[hledger terminology]]
[[Create a journal]]
2019-02-12 01:24:40 +03:00
[[hledger accounting concepts]]
2019-02-10 06:23:39 +03:00
[[Common journal entries]]
2019-02-12 03:41:57 +03:00
[[FAQ]]
2019-02-12 04:25:42 +03:00
[[Accounting links]]
2019-01-20 03:49:36 +03:00
2019-02-10 06:23:39 +03:00
### Managing data
2019-01-20 03:49:36 +03:00
2019-02-10 06:23:39 +03:00
[[Convert CSV files]]
[[Customize default CSV accounts]]
[[Track changes with version control]]
[[Use another account separator character]]
2019-01-20 03:49:36 +03:00
### Reporting
2019-02-10 06:23:39 +03:00
[[Queries]]
[[hledger tags tutorial]]
[[Rewrite account names]]
2019-01-20 03:49:36 +03:00
2019-03-16 03:41:33 +03:00
### Real world setups
2019-03-06 20:46:37 +03:00
2019-03-09 00:00:12 +03:00
[[About real world setup docs]]
2019-03-06 20:46:37 +03:00
["Full-fledged Hledger" tutorial ](https://github.com/adept/full-fledged-hledger ) →
2019-04-07 00:00:04 +03:00
["Hledger Flow" tutorial & slideshow ](https://github.com/apauley/hledger-flow ) →
2019-03-09 00:26:03 +03:00
[[Simons setup]]
2019-03-06 20:46:37 +03:00
2019-01-20 03:49:36 +03:00
### Accounting tasks
2019-02-10 06:23:39 +03:00
[[hledger multicurrency tutorial]]
[[Foreign trip expenses]]
[[Budgeting and forecasting]]
[[Project accounting]]
[[Track investments]]
[[Time planning]]
2019-01-20 03:49:36 +03:00
### Usage tips
2019-02-10 06:23:39 +03:00
[[Addons]]
2019-02-12 23:13:24 +03:00
[[Command-line completion]]
2019-02-12 20:51:51 +03:00
[[Editor configuration]]
2019-02-25 08:33:00 +03:00
[[hledger-web tips]]
2019-02-10 06:23:39 +03:00
[[Mobile apps]]
[[Save frequently used options]]
2019-02-12 04:25:42 +03:00
[[Scripting]]
2019-01-20 03:49:36 +03:00
2019-02-12 04:25:42 +03:00
### See also...
2019-01-20 03:49:36 +03:00
2019-02-12 04:25:42 +03:00
[plaintextaccounting.org ](http://plaintextaccounting.org )
2019-02-10 06:23:39 +03:00
([software](http://plaintextaccounting.org/#software),
[docs ](http://plaintextaccounting.org/#docs ),
[common tasks ](http://plaintextaccounting.org/#common-tasks ),
2019-02-12 04:25:42 +03:00
[discussion ](http://plaintextaccounting.org/#discussion ))
→
[Ledger ](http://ledger-cli.org )
2019-02-10 06:23:39 +03:00
([docs](https://www.ledger-cli.org/docs.html),
2019-02-12 04:25:42 +03:00
[wiki ](https://github.com/ledger/ledger/wiki ))
→
[Beancount ](http://furius.ca/beancount )
([docs](http://furius.ca/beancount/doc/index))
→
2018-04-28 21:46:42 +03:00
<!-- ENDWIKICONTENT -->
2016-02-21 23:39:32 +03:00
< / div >
< / div >
2017-01-12 20:25:32 +03:00
2018-04-28 21:46:42 +03:00
< / div > <!-- column -->
< / div > <!-- row -->
< / div > <!-- container -->