Skip to content

theo79/viosimos

Repository files navigation

Viosimos - Βιώσιμος (Sustainable)

Viosimos Logo

Viosimos (Βιώσιμος in Greek, meaning Sustainable) is a simple client-side web app to track energy (electricity), gas, and water consumption. It helps you input meter readings, calculate usage and costs, visualize trends, and manage your utility data locally or via export/import.

Features

-- Track electricity, gas, and water meter readings, tariffs, and dates

-- Auto calculate usage and costs between readings

-- Dashboard overview combining all utilities

-- Monthly summaries for usage and costs

-- Interactive charts using Chart.js

-- PDF report export from the dashboard

-- Data saved in browser local storage (LocalForage)

-- Export/Import CSV and JSON backups

-- Responsive design for all devices

-- Clean, easy-to-use interface


Getting Started

  1. Clone the repo:

    git clone https://github.com/theo79/viosimos.git
    cd viosimos
  2. Open index.html in your favorite browser (Chrome, Firefox, Edge).

  3. Start entering your meter data and explore the features!


Project Structure

index.html - Home page dashboard.html - Combined utilities dashboard energy.html - Electricity tracking gas.html - Gas tracking water.html - Water tracking style.css - Stylesheet viosimos.png - Logo image license.txt - License (CC BY-NC 4.0) README.md - This file


Technologies Used


Future Improvements

  • User accounts and cloud sync
  • Cost projections
  • Meter reading reminders
  • Multi-currency support
  • Light/Dark themes

License

This project is licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). See license.txt for details.


Author

Theocharis Anastopoulos © 2025


Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4


Thank you for using Viosimos — helping you be sustainable one meter reading at a time!

About

Viosimos is a lightweight browser-based utility tracker for electricity, gas, and water consumption. It helps users record meter readings, calculate usage and costs, visualize trends, and export reports locally with no backend.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors