simonmichael/hledger

Features

• Double-Entry Accounting Tools - Manages financial records using double-entry bookkeeping stored in human-readable plain text files.
• Double-Entry Bookkeeping Engines - Implements a core double-entry bookkeeping engine that ensures every transaction balances to zero.
• Clipboard-Based Selection - Provides configurable lot-matching strategies including FIFO, LIFO, and Average Cost for asset disposal.
• Financial Data Analysis - Generates balance sheets and income statements from ledger data using command-line tools and APIs.
• Financial Report Generators - Produces formatted financial reports such as balance sheets and income statements from accounting data.
• Financial Account Categorization - Organizes financial accounts into standard types such as assets, liabilities, and revenues for bookkeeping.
• Hierarchical Account Structures - Organizes financial accounts into a tree structure using colon-separated naming conventions for aggregated reporting.
• Asset Valuation Systems - Calculates the current value of multi-currency holdings by applying historical price directives to asset quantities.
• Category Budget Trackers - Sets spending limits and tracks actual expenditures against planned budget categories.
• Budget Variance Reporters - Defines recurring financial targets and generates reports comparing actual spending against these goals.
• Multi-Currency Ledger Management - Records financial movements across different currencies with integrated exchange rate tracking.
• Plain-Text Journal Workflows - Stores financial transactions in human-readable plain-text files to enable version control and direct editing.
• Double-Entry Equation Verifications - Ensures the ledger remains mathematically sound by verifying that assets, liabilities, and equity align with double-entry principles.
• Financial Statement Generations - Generates formal balance sheets, income statements, and cashflow reports by detecting account types.
• Investment Performance Analysis - Calculates market values, purchase costs, and rates of return for investments across multiple currencies.
• Net Income Calculations - Calculates totals for revenue and expense accounts over a period to determine net income.
• Account Hierarchies - Organizes financial data using a hierarchical tree structure of master and sub-accounts.
• Personal Finance Management - Tracks spending, manages budgets, and forecasts future balances to maintain overall financial health.
• Investment Portfolio Tracking - Monitors asset cost basis and market prices to calculate realized and unrealized capital gains.
• Lot Tracking - Tracks individual asset acquisition lots and disposals to calculate cost basis and realized capital gains.
• Booking Strategies - Implements FIFO and other booking strategies to match asset lots for sale transactions.
• Market Price Fetching Tools - Uses CLI tools and scripts to define and retrieve market values for commodities at specific times.
• Asset Valuation Logic - Converts commodity amounts to a target currency using market price directives or inferred prices.
• Terminal-Based Accounting Interfaces - Provides a command-line interface for entering, editing, and viewing double-entry accounting data.
• Trial Balance Generation - Sums all inflows and outflows across all accounts to confirm that total debits and credits are equal.
• Unrealized Gain/Loss Reports - Computes realized and unrealized gains using asset lot tracking.
• Realized Gain Calculations - Determines profit or loss from selling assets by comparing original cost basis with final sale price.
• Balance Tracking - Maintains and displays running totals for account registers with historical and period-specific views.
• Journal Balance Summaries - Produces summaries of account balances from plain-text journals, toggling between historical and period views.
• Cost Basis Trackers - Tracks individual asset acquisition lots and validates their cost basis against transacted costs.
• Double-Entry CSV Importers - Transforms CSV files into double-entry transactions using rules to map columns, dates, and account names.
• Commodity Value Calculation - Converts commodity amounts to a target currency using declared market prices or inferred costs for valuation.
• CLI Data Processors - Processes journal files and transforms financial data into plain text or CSV formats via the terminal.
• Command Line Interfaces - Provides a terminal-based interface for querying financial data and managing ledger journals via CLI and TUI.
• Balance Forecasting - Predicts future financial states by applying recurring budget rules to reports beyond the last transaction.
• Asset Cost Reports - Displays the original acquisition price or sale value of an asset in a different currency.
• Report Dimension Pivoting - Groups and totals report data by fields other than account names, such as tags or payees.
• Transaction Register Reports - Generates chronological lists of account changes and balances exported as CSV or TSV files.
• Time Tracking - Uses double-entry bookkeeping principles to log work hours and analyze labor productivity.
• Billable Hour Tracking - Logs project time and generates monthly reports to facilitate client invoicing and productivity management.
• Session-Based - Logs work sessions using a timeclock format that calculates durations between start and end entries.
• Account Alias Mapping - Translates account identifiers using aliases to consolidate data from multiple journals into one chart of accounts.
• Account Name Rewriting - Rewrites account names using regular expressions to simplify reports or adapt legacy journals.
• Accounting Web Interfaces & APIs - Hosts a browser-based UI and JSON API to enable remote transaction entry and third-party tool integration.
• Budget Allocation - Assigns funds to specific purposes using virtual subaccounts to manage planned expenses.
• Time Allocation Goals - Sets periodic goals for time expenditure using transaction rules across daily or weekly intervals.
• Variance Reports - Compares actual logged time against defined budgets to report on allocation usage.
• Commodity Symbol Mapping - Replaces currency or asset symbols in reports using text processing or market price conversions.
• Currency Normalization - Normalizes multiple currencies into a single reference currency for unified financial reporting.
• Interactive Entry Prompts - Provides interactive prompts for transaction details and appends them to the journal using smart defaults.
• International Accounting - Handles multi-currency transactions and converts values for unified financial reporting.
• Transaction Filters - Filters account registers based on transaction statuses such as marked, pending, or cleared.
• Transaction Tag Filters - Assigns labels and key-value pairs to transactions for categorized reporting without altering the account hierarchy.
• Financial Data Visualization Servers - Provides a web-based server to browse journals and filter transactions through a browser.
• Financial Management GUIs - Provides desktop and mobile graphical applications for financial data entry, budgeting, and reporting.
• Financial Report Filtering - Uses regular expressions and field queries to restrict reports to specific dates, accounts, or descriptions.
• Financial Trend Visualizations - Creates charts and plots of account balances and spending trends to identify financial patterns.
• Ledger File Validators - Scans transaction files for syntax errors and balance assertion failures to ensure ledger accuracy.
• Integration APIs - Provides a web API and library for building third-party integrations and automated scripts.
• Investment Return Calculations - Computes time-weighted and money-weighted rates of return to analyze the performance of investment accounts.
• Journal Correctness Scanning - Scans journal files for balancing errors, date ordering issues, and undeclared accounts to ensure data integrity.
• Loan and Credit Tracking - Monitors borrowed and lent funds including the calculation of accrued interest.
• Opening Balance Initializations - Establishes initial asset and liability totals by recording starting balances against equity accounts.
• Lot Expansion - Restructures postings to show explicit cost bases and splits transactions into individual lot subaccounts for detailed analysis.
• Spending Average Analysis - Calculates average expenditures over specific time intervals to establish baseline figures for budgeting.
• Time-to-Currency Conversions - Calculates the monetary value of tracked time by applying specific hourly rates to transactions.
• Transaction Automation - Creates temporary recurring transactions based on periodic rules to project future financial activity.
• Transaction Automation Rules - Creates temporary or recurring postings by applying predefined periodic patterns and matching queries.
• Automated Ledger Posting - Generates forecast transactions and auto-postings using predefined periodic rules and existing journal data.
• Bank Statement Ingestion - Imports and converts CSV bank statements into structured double-entry transactions using mapping rules.
• Transaction Detail Retrievers - Displays complete journal entries based on account or date filters with all balanced amounts.
• Web-Based Financial Management - Provides a web application for viewing financial reports and managing transactions through a browser.
• Transaction History Views - Provides chronological listings and drill-down views of transactions affecting specific accounts.
• Balance Verification - Compares recorded ledger balances against real-world statements to identify and resolve financial discrepancies.
• Loan - Tracks the lifecycle of loans by monitoring principal and interest payments over time.
• Cash Flow Analysis - Predicts future account balances and cash flow based on historical data and scheduled entries.
• Currency Exchange Recording - Records currency exchanges within a double-entry ledger using implicit or explicit cost markers.
• Financial Transaction Importers - Aggregates transaction data from external financial institutions via APIs to populate accounting journals.
• Data Query Filters - Restricts financial reports to specific data subsets using regular expressions, date ranges, and metadata tags.
• Data Validation - Runs correctness checks to identify unbalanced transactions, undeclared accounts, and invalid commodity symbols.
• Accounting Ledger Viewers - Provides a user interface for navigating accounts and transactions with drill-down capabilities.
• Financial Data Explorers - Provides an interactive terminal menu system to browse accounts and inspect transaction registers.
• JSON API Servers - Exposes financial data and transaction endpoints through a structured JSON interface for programmatic access.
• Ledger Data Filtering - Narrows the list of visible accounts or transactions using search queries to locate specific entries.
• Account Ledger Auditing - Enables validation of account balances and postings against custom restriction rules and complex assertions.
• Share Price Index Retrievals - Retrieves historical and current currency and stock prices from external providers as accounting directives.
• Financial Account Aggregators - Calculates total values for individual or aggregated parent accounts with depth filtering.
• CLI Extension Frameworks - Allows extending the command-line interface with custom subcommands using external binaries.
• Command-Line Configurations - Manages recurring command-line options and application behavior via a configuration file.
• Command Sequence Automation - Executes predefined sequences of accounting commands from scripts to automate repetitive tasks.
• Interactive REPLs - Provides an interactive read-eval-print loop to run multiple commands without re-parsing data files.
• Accounting Automation Interfaces - Provides programming interfaces for automating financial accounting tasks via CLI or API scripting.
• Custom Plugin Registrations - Provides a system for registering custom readers, processors, and reports through external scripts.
• Financial Charting - Creates bar charts and line graphs to represent posting counts and investment returns.
• Journal Syntax Validation - Scans journal files for balancing errors and syntax warnings during editing to provide real-time feedback.
• Hybrid Access Interfaces - Provides multiple interaction models for the same core logic, including a CLI, TUI, and web server.
• Terminal User Interfaces - Provides a terminal-based interface to navigate account balances, income statements, and registers.
• Hosted Web Interfaces - Delivers a web-based user interface for managing journal files via network ports or Unix sockets.
• Personal Finance - Plaintext accounting tool with CLI and web interfaces.

Star history