Skip to content

joe-mccarthy/odometer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Odometer

Python License Issues Latest Commit

Odometer is a local-first CLI application for tracking the true cost of owning a vehicle.

It helps you answer a simple question:

What does this car actually cost me?

Unlike basic fuel trackers, odometer records every ownership expense — fuel, servicing, insurance, tax, repairs, finance — and calculates meaningful metrics like cost per mile and total cost of ownership.

Philosophy

Odometer is designed to be:

  • Local-first
  • Privacy respecting
  • Multi-vehicle
  • CLI-first
  • Docker-friendly
  • Extensible (TUI and web UI planned)

No cloud. No subscriptions. Your data stays with you.

Features (Planned)

  • Track multiple vehicles by registration
  • Record all ownership expenses
  • Fuel logging with mileage tracking
  • Cost per mile calculations
  • Monthly and annual cost summaries
  • Expense breakdown by category
  • SQLite storage (PostgreSQL optional later)
  • Docker support

Roadmap

v0.1 – Core CLI

  • Vehicle management
  • Expense logging
  • Basic summaries
  • SQLite backend
  • Docker support

v0.2 – Calculations Engine

  • Cost per mile
  • Fuel economy (MPG)
  • Rolling averages
  • Category breakdowns

v0.3 – TUI Interface

  • Interactive dashboard
  • Expense tables
  • Cost graphs (terminal-based)

v1.0 – Web Interface

  • API layer
  • Self-hosted web dashboard
  • Multi-user support (optional)

License

Odometer is open source and released under the GNU General Public License v3.0 (GPL-3.0).

See the LICENSE file for details.

About

A local-first CLI tool for tracking the true cost of vehicle ownership — fuel, maintenance, insurance, and total cost per mile

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors