This is a collection of small single-purpose programs to aid your accounting with Ledger (ledger-cli). Think of it as the batteries that were never included with Ledger.
Why should you use them? Because:
- All the ledgerhelpers have been designed with fast data entry in mind, and they will remember or evoke existing data as needed, to help you minimize typing and other drudgery.
- They all have launcher icons in your desktop environment -- this makes it very easy to add icons or shortcuts for them, so you can run them on the spot.
This package also contains a library with common functions that you can use in your project to make it easier to develop software compatible with Ledger.
- Enter transactions easily with addtrans.
- Update your price quotes with updateprices.
- Record multi-currency ATM withdrawals with withdraw-cli.
- Record FIFO stock or commodity sales with sellstock-cli.
- Interactively clear transactions with cleartrans-cli.
- Keep your ledger chronologically sorted with sorttrans-cli.
See also individual manual pages in NROFF format.
Here are instructions to install the very latest iteration of ledgerhelpers:
If you are on a Linux system and want to install it as an RPM package:
- Obtain the package with
git clone https://github.com/Rudd-O/ledgerhelpers - Change to the directory
cd ledgerhelpers - Create a source package with
python3 -m build --sdist - Create a source RPM with
rpmbuild --define "_srcrpmdir ./" --define "_sourcedir dist/" -bs *.spec- You may need to install some dependencies at this point. The process will tell you.
- Create an installable RPM with
rpmbuild --rebuild --nodeps --define "_rpmdir ./" *.src.rpm- You may need to install some dependencies at this point. The process will tell you.
- Install the package with
sudo rpm -Uvh noarch/*.noarch.rpm
In other circumstances or Linux systems:
- Obtain the package with
git clone https://github.com/Rudd-O/ledgerhelpers - Change to the directory
cd ledgerhelpers - Create the source package directly with
python3 -m build --sdist - Install the package (to your user directory
~/.local) withpip3 install dist/*.tar.gz- This will install a number of dependencies for you. Your system should already have the GTK+ 3 library and the Python GObject introspection library.
The programs in bin/ can generally run from the source directory, provided
that the PYTHONPATH points to the src/ folder inside the source directory,
but you still need to install the right dependencies, such as GTK+ 3 or later,
and the Python GObject introspection library.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
See full license terms.