GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com β€” GitHub - algirdasc/expensave: Personal and family expense tracking and budgeting application, enabling better financial management

BranchesTags
Open more actions menu

Latest commit

 

History

632 Commits
632 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills/bump-version
.agents/skills/bump-version
 
 
.github
.github
 
 
backend
backend
 
 
docker
docker
 
 
docs
docs
 
 
frontend
frontend
 
 
.dockerignore
.dockerignore
 
 
.gitignore
.gitignore
 
 
.nvmrc
.nvmrc
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
docker-compose.development.yml
docker-compose.development.yml
 
 
docker-compose.yml
docker-compose.yml
 
 
install.sh
install.sh
 
 
paseo.json
paseo.json
 
 

Repository files navigation

Expensave

Expensave is a free, open-source self-hosted expense tracker for personal and family budget management. Track spending, share calendars with family members, import bank statements, and monitor your finances β€” all on your own server.

License: GPL v3 GitHub release Docker Pulls


Screenshots

Desktop

Expensave desktop calendar view Expensave desktop expense dialog

Calendar & editing: browse your timeline, review entries, and create or edit transactions.

Expensave desktop report view Expensave desktop light theme view

Reports & themes: analyze spending trends and use Expensave in light or dark mode.

Mobile

Expensave mobile overview Expensave mobile expense dialog Expensave mobile reports overview

Mobile experience: manage expenses, edit entries, and review reports on smaller screens.


Features

  • πŸ‘₯ Multiple user support
  • πŸ“… Shared expense calendars between family members
  • ♾️ Multiple & unlimited expense calendars
  • πŸ” Recurring expenses β€” daily, weekly, monthly, and yearly schedules
  • 🏦 Import bank statements in various formats β€” OFX/QFX, ISO 20022 XML, Revolut, Dollarbird
  • πŸ“Š Reports on spending and income habits
  • πŸ€– AI assistant integration β€” manage expenses from Claude, Cursor, and other AI tools via the built-in MCP server
  • πŸ“± Mobile PWA β€” installable on iOS and Android
  • 🎨 Responsive design β€” works on desktop, tablet, and mobile

Quick Start

Option 1 β€” Automated installer (recommended)

Requires Docker. Installs and starts Expensave interactively:

curl -fsSL https://expensave.app/install.sh | sudo bash

The installer will:

  • Verify Docker is installed and running
  • Ask whether to use default or custom settings
  • Configure timezone and locale from your OS automatically
  • Generate a secure database password
  • Pull images and start the application
  • Print the URL and credentials when done

Option 2 β€” Docker Compose (manual)

1. Create a directory and download the compose file:

mkdir -p /opt/expensave && cd /opt/expensave
curl -fsSL https://raw.githubusercontent.com/algirdasc/expensave/main/docker-compose.yml -o docker-compose.yml

2. Create a .env file:

cat > .env <<EOF
TZ=Europe/Vilnius
LOCALE=en
REGISTRATION_DISABLED=no
EOF

3. Start:

docker compose up -d

App is available at http://localhost:18000

Useful commands:

docker compose logs -f          # view logs
docker compose pull && docker compose up -d   # update to latest
docker compose down             # stop

Option 3 β€” Deploy on Hostinger VPS

One-click deploy on a Hostinger VPS with Docker pre-configured:

Deploy on Hostinger


Mobile PWA

Expensave works as a Progressive Web App β€” install it on your phone directly from the browser, no app store required.

See wiki: Using mobile version.


Bank Statement Import

Import your balance from financial institutions in various formats:

  • OFX / QFX β€” supported by most US banks (Chase, Bank of America, Wells Fargo, Citi, American Express, …). Look for a "Quicken (QFX)", "Web Connect" or "OFX" download option in your internet bank. Both bank account and credit card statements are supported.
  • ISO 20022 XML (camt.053, versions .001.02–.001.08) β€” the standard SEPA statement format offered by most European banks (Luminor, ING, Nordea, mBank, …).
  • Revolut β€” CSV statement exported from the Revolut internet bank.
  • Dollarbird β€” CSV data export, for migrating from Dollarbird.

See wiki for detailed export instructions: Bank statement import.


AI Assistants (MCP)

Expensave exposes a built-in MCP (Model Context Protocol) server at /_mcp, so AI assistants like Claude, Cursor, or pi can manage your expenses programmatically β€” add, update, and delete expenses, browse calendars and categories, and generate spending reports β€” with the same permissions as the web app.

Point your MCP client at https://your-expensave-host/_mcp with a Bearer token from the login endpoint, and ask things like "add a 12.50 grocery expense for today" or "show my monthly spending report".

See wiki for setup, client configuration, and the full tool list: MCP server (AI assistants).


Community & Discussions

Have a question, idea, or want to share how you use Expensave?

πŸ‘‰ Join the discussion on GitHub

  • πŸ’‘ Ideas & feature requests β€” suggest what you'd like to see
  • ❓ Q&A β€” ask questions and get help from the community
  • πŸ—£οΈ Show & tell β€” share your setup or how you use Expensave

Support

πŸ’¬ Bug reports & questions

Found a bug or need help?

  • Open an issue for bug reports
  • Start a discussion for questions and ideas

❀️ Financial support

Expensave is developed and maintained in my free time. If you find it useful, consider supporting the project:

  • Click the Sponsor button at the top of this page
  • Your support helps me dedicate more time to new features, bug fixes, and keeping the project alive
  • It also lets me know that Expensave is useful to others β€” which means a lot

License

Expensave is open-source software licensed under the GNU General Public License v3.0.

About

Personal and family expense tracking and budgeting application, enabling better financial management

Topics

budgetingcalendarfamilyfinancespersonalplanning

Resources

Readme
GPL-3.0 license

Contributing

Contributing
Activity

Stars

59 stars

Watchers

1 watching

Forks

9 forks
Report repository

Releases

Sponsor this project

Used by

Contributors

Languages

You are visitor 01402503 β€” GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800Γ—600. No cookies required.