diff options
-rw-r--r-- | README.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..f6a8dfa --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +## Introduction + +This is just a hacky import script that reads YNAB exports (budget and +register) and produces ledger output to stdout. + +## What it does + +It transforms the budget into a set of virtual transactions at the +first of the month (or the day of the opening balance, for the first +month) balanced against the Assets account. Categorised transactions +are exported with a non-balanced virtual posting to reduce the +category amount. It guesses whether an account should be an asset or +a liability by its starting balance (anything positive denotes an +asset), or by the presence of “credit” in the account name. Memos are +transformed into comments, either on the transaction or, for split +transactions, on each posting. + +## Status + +It mostly works and has served its purpose for me. It doesn’t work so +well with off-budget accounts, although transferring into them seems +fine, if they have any income it will not be categorised correctly. + +I don’t expect to develop this further, unless there is specific need. +I haven’t tested it with currencies other than the British Pound. Let +me know if something doesn’t work (ideally with some test data) and +I’ll try to fix it. + +If you want to fix it yourself, go ahead. I’ll merge any pull request +that looks reasonable and works with my own data. + +## Usage + +``` +composer install +./main.php convert /path/to/budget.csv /path/to/register.csv > new-ledger-file.dat +``` + +## License + +The project is licensed under the BSD 3-Clause License. |