Repolode
Submit
simonwep

simonwep/ocular

A self-hosted, Vue-based personal budgeting app for tracking expenses and income across multiple years, deployable with Docker.

View on GitHubWebsite
Stars
580
Forks
51
Open issues
21
Last commit
3 days ago

What is it?

Ocular is an open-source budget tracker that lets you plan and record your spending and income across multiple years. It is built with Vue 3 and deployed as a single container, so you can run it on your own server and keep your financial data under your control.

The app includes a dashboard with multiple charts, including a Sankey diagram, plus an all-time overview of your budgets. It supports multiple languages and all common currencies, a light and dark theme, and a financial year that can start in any month. Budgets can be carried over to the next year, and expressions can be evaluated inline when entering amounts.

Data can be imported from a Google Sheets annual planner and exported as JSON. User management and authentication are handled through the app and a command-line interface. The app is installable as a Progressive Web App and has a privacy mode for use in public places.

Key features

  • 01Self-hosted deployment via a single Docker container.
  • 02Dashboard with multiple charts, including a Sankey diagram.
  • 03Budget tracking across multiple years with carry-over to the next year.
  • 04Customizable financial year that can start at any month.
  • 05Import from Google Sheets and export as JSON.
  • 06Installable as a Progressive Web App with light and dark themes.

Use cases

  • Tracking household or personal budgets year over year on your own server.
  • Moving an existing Google Sheets annual budget planner into a dedicated app.
  • Sharing a self-hosted budget tool with several users through built-in user management.

Quick start

  1. 1

    Read the getting started guide linked in the README

  2. 2

    Deploy it with Docker by following the deploy guide linked in the README

In collections

Self-hosted apps

Topics

#budgeting#personal-finance#expense-tracker#self-hosted#vue3#docker#budget-analysis#budget-app#budget-manager#budget-planner

FAQ

What is ocular?
A self-hosted, Vue-based personal budgeting app for tracking expenses and income across multiple years, deployable with Docker. Ocular is an open-source budget tracker that lets you plan and record your spending and income across multiple years. It is built with Vue 3 and deployed as a single container, so you can run it on your own server and keep your financial data under your control.
Is ocular free to use? What license does it have?
ocular is open source under the MIT license. Check the license terms before using it in commercial products.
Is ocular still maintained?
Actively maintained. The last commit to ocular was on Nov 4, 2026.
What can I use ocular for?
Tracking household or personal budgets year over year on your own server. Moving an existing Google Sheets annual budget planner into a dedicated app. Sharing a self-hosted budget tool with several users through built-in user management.
How do I install ocular?
Read the getting started guide linked in the README Deploy it with Docker by following the deploy guide linked in the README
Where can I get ocular?
The source code and installation instructions are on GitHub: https://github.com/simonwep/ocular

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects