endspent - Linux


endspent is a command used to check, modify, or create an end-of-month or end-of-quarter spending report. It provides options to categorize expenditures in various ways, including by project, department, or cost center. This tool is particularly useful for financial managers and small business owners who need to track and control their expenses.


endspent [options] [arguments]


  • -c, –category category: Specify an expense category for the report.
  • -d, –date date: Set the end date for the report in YYYY-MM-DD format.
  • -p, –project project: Filter the report by a specific project.
  • -o, –output-file file: Save the report to a file.
  • -v, –verbose: Display additional information in the report.
  • -h, –help: Print usage information.


1. Generate a basic end-of-month report:

endspent -d 2023-06-30

2. Filter the report by project and category:

endspent -p ProjectA -c Travel

3. Save the report to a file:

endspent -d 2023-06-30 -o report.csv

4. Display verbose output including transaction details:

endspent -d 2023-06-30 -v

Common Issues

  • Date format: Ensure the date is in the correct format (YYYY-MM-DD).
  • Undefined category: If a category is specified that does not exist in the database, an error will occur.
  • Invalid file path: When saving the report to a file, ensure that the file path is correct and has write permissions.


  • grep: Filter the report output based on specific keywords.
  • sed: Manipulate the report text and reformat it.
  • awk: Extract specific fields from the report and perform calculations.

Related Commands

  • ledger: A double-entry accounting system for tracking financial transactions.
  • gnucash: A personal and small business finance management software.