https://github.com/lsgalves/hledger-obsidian

Plain text accounting plugin for Obsidian, using hledger
https://github.com/lsgalves/hledger-obsidian

hledger obsidian-md obsidian-plugin personal-finance plaintext-accounting

Last synced: 13 days ago
JSON representation

Plain text accounting plugin for Obsidian, using hledger

• Host: GitHub
• URL: https://github.com/lsgalves/hledger-obsidian
• Owner: lsgalves
• License: 0bsd
• Created: 2026-06-03T00:56:41.000Z (15 days ago)
• Default Branch: main
• Last Pushed: 2026-06-03T02:09:50.000Z (15 days ago)
• Last Synced: 2026-06-03T03:06:01.341Z (15 days ago)
• Topics: hledger, obsidian-md, obsidian-plugin, personal-finance, plaintext-accounting
• Language: TypeScript
• Homepage: https://community.obsidian.md/plugins/hledger
• Size: 154 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# Hledger for Obsidian

Parse a configured [hledger](https://hledger.org) journal file (`.journal` / `.ledger`)

from your vault and view it as a native dashboard with interactive charts.

## Features

- Reads a single configured journal file; `include` directives are resolved recursively.

- Dedicated dashboard view (ribbon icon + "Open dashboard" command).

- Summary cards: net worth, income, expenses, savings.

- Interactive charts (Chart.js, themed to your Obsidian theme):

  - Net worth over time

  - Income vs expenses (monthly)

  - Expenses by category

  - Account balances + recent transactions

- Period filter (month / 12 months / year / all), commodity selector, and account

  filter (scopes the category, balances, and recent-transaction panels to a subtree).

- Account classification configurable for English or Portuguese account names.

## Screenshots

![Overview tab](https://github.com/user-attachments/assets/447452fc-9ce1-4d80-aeaf-9fa8c96c10e5)

![Expenses tab](https://github.com/user-attachments/assets/ea6c8a04-9662-4362-81d0-ef3dca9cb70c)

![Income tab](https://github.com/user-attachments/assets/a3d385f8-2d73-4d47-9596-86736eed9710)

![New entry screen](https://github.com/user-attachments/assets/113230bf-8a06-4343-88bb-678b20875b12)

## Setup

1. Enable the plugin.

2. In **Settings → Hledger**, set **Journal file path** to your main file

   (e.g. `finance/main.journal`).

3. Open the dashboard via the wallet ribbon icon or the command palette.

## Notes

- Currency conversion is not performed; pick a commodity to view.

- Number formats (`1,234.56`, `1.234,56`, `240,50`) are detected heuristically.

## Development

- `npm run dev` — watch build

- `npm run build` — production build

- `npm test` — run unit tests (Vitest)