Ledger-cli is a powerful, double-entry accounting system that is accessed from the UNIX command-line. ledger-cli keeps account transactions in a simple text file and it is easy to use, fast and more powerful.
I am using ledger-cli since 2016 and I love it a lot.
I have been spending money mostly when I am outside. I used to keep costs by writing them to a note-keeping app on a mobile phone. Writing expenses from mobile and rewriting them to ledger-cli journal file a little hard and time-consuming work. So I wrote the teledger bot which you can use it to create and report ledger-cli transactions easily.
The final goal is to easily do all the works that can be done with ledger-cli.
- Adding and deleting transactions
- Using aliases
- Balance report
- Download ledger file
- Budget reports
- Execution of custom ledger commands
- Raw ledger-cli command mode
- Daily expense reminder
- Create a telegram bot with BotFather and get token of created bot.
- Set required environment variables
TELEDGER_TELEGRAM_TOKEN=
TELEDGER_JOURNAL_DIR=
go run .
You can show accounts which used when adding transactions. Account names reading from ledger journal file.
You can add transactions easily with simple syntax.
[Day.Month] fromAccount,toAccount amount [payee]
Adding transaction syntax examples:
Checkings,food 20.15
Checkings,food 20.15 dinner
20.12 Checkings,food 20.15
20.12 Checkings,food wp.qt (using qwertyuiop keys for amount)
You can delete added transaction using transaction id:
Adding new alias syntax is simple:
A AliasName AccountNake
Alias names adding to journal files also account names will be written to journal file instead alias names when you add a new transaction.
You can report account balances with b
command.
B [aliasName|accountName]
MIT