https://github.com/slashdotdash/node-ledger-import
Import accounting transactions from CSV files to Ledger format.
https://github.com/slashdotdash/node-ledger-import
Last synced: about 1 year ago
JSON representation
Import accounting transactions from CSV files to Ledger format.
- Host: GitHub
- URL: https://github.com/slashdotdash/node-ledger-import
- Owner: slashdotdash
- Created: 2014-01-14T22:32:21.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2015-09-27T21:02:06.000Z (over 10 years ago)
- Last Synced: 2025-03-17T03:34:21.925Z (about 1 year ago)
- Language: JavaScript
- Size: 221 KB
- Stars: 11
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ledger Import
Import accounting transactions from a CSV file into Ledger, using naive Bayesian learning to identify accounts from each payee. Heavily inspired by the Reckon Ruby gem.
> Ledger is a powerful, double-entry accounting system that is accessed from the UNIX command-line.
## Dependencies
* [Ledger 3](http://ledger-cli.org/)
* [Node.js](nodejs.org) and npm
### Installing Ledger
The simplest way to install Ledger 3 is through [Homebrew](http://mxcl.github.com/homebrew/).
brew install ledger --HEAD
The `--HEAD` option is required to install version 3.x.
## Usage
Install `ledger-import` and its dependencies with npm.
npm install -g ledger-import
Then run the import tool, providing the relevant command line arguments for the CSV you are attempting to parse.
ledger-import --file /path/to/transactions.csv --account 'Assets:Current Account' --ledger /path/to/ledger.dat --currency '£' --contains-header --date-column 1 --date-format 'DD/MM/YYYY' --payee-column 2 --amount-column 3
### Command line help
$ ledger-import
Usage: ledger-import [options]
Options:
-h, --help output usage information
-V, --version output the version number
-f, --file The CSV file to parse
-a, --account The Ledger Account this file is for
-i, --inverse Use the negative of each amount
-v, --verbose Run verbosely
-l, --ledger An existing ledger file to learn accounts from
-c, --currency Currency symbol to use, defaults to £ ($, EUR)
--contains-header The first row of the CSV is a header and should be skipped
--csv-separator Separator for parsing the CSV, default is comma.
--date-column Column containing the date in the CSV file, the first column is column 1
--date-format Force the date format
--payee-column Column containing the payee (description) in the CSV file
--amount-column Column containing the amount in the CSV file
--amount-columns Multiple columns containing the amount in the CSV file