Skip to content
AtrenaPublic

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CarConso

Fuel consumption and cost tracker for your car
Simple, offline, no account, no ads. In English and French.

Web app · Download the APK · Privacy · Version française


Features

⛽ Fill-ups Volume, price, odometer or distance, partial fill-ups, blends of compatible fuels (e.g. E10 + E85).
🚗 Several vehicles Petrol or diesel, tank capacity, fuels offered, default fuel.
🔧 Expenses Service, insurance, tolls… one-off or recurring (monthly, yearly…).
📊 Statistics Average consumption, cost per km or mile, comparison by fuel, monthly spending, forecast, period filter.
🧮 Simulator Which fuel is cheapest per 100 km at today's pump prices, and the E85 break-even price.
🌍 Language and country English or French, detected automatically. The country sets the local fuel names and list (SP-95 in France, Regular / Premium in the US, Super E10 in Germany…) and the default units.
🎨 Customisation Light / dark theme, colour, text size, compact layout, units (L/100 km, km/L, mpg, km or miles, litres or US gallons, currency), start screen, visible tabs.
💾 Data Backup / restore to a file, CSV exports for Excel. In the Android app: automatic backup with the phone's Google backup.

Supported countries: France, Belgium, Luxembourg, Switzerland, Canada, United Kingdom, Ireland, United States, Germany, Austria. Other countries use international fuel names.

Privacy

No data is collected: no account, no server, no usage analytics. Everything stays on your device, and the Android app asks for no permission. Details: privacy policy.

Installation

  • Android: download the APK from the latest release (installing apps from unknown sources must be allowed). Coming soon to Google Play.
  • iPhone, computer, or Android without installing: open the web app, then add it to the home screen (Chrome: menu ⋮ › Install app; Safari: Share › Add to Home Screen).

The web app and the Android app keep separate data: to move from one to the other, use Settings › Data › Full backup, then Restore from a file.

How consumption is calculated

CarConso uses the fill-to-fill method:

  • the distance entered is the one driven since the previous fill-up;
  • the litres of a full fill-up replace exactly what was burned over that distance; partial fill-ups add up until the next full one;
  • the first full fill-up is only a reference (its distance is optional): the first consumption appears at the next one;
  • the consumption is credited to the fuel that was in the tank (the previous fill-up's), which makes comparisons between fuels and blends reliable;
  • the cost of a trip uses the price paid for that fuel, so the cost per km never counts the fuel still in the tank.

Development

The app is plain HTML, CSS and JavaScript, with no framework and no build step. The same code runs the website (GitHub Pages, from the main branch) and the Android app (through Capacitor).

index.html, style.css      user interface
i18n.js                    translations, countries, fuel names
stats.js                   calculations (consumption, blends, forecast, simulator)
storage.js                 local storage, settings, import / export
native.js                  Android-only features
app.js, *-view.js          screens (Fill-up, History, Expenses, Stats, Simulator, Settings)
vendor/                    Chart.js
android/                   Android project (Capacitor)
assets/, store/            icons, splash screen, Google Play images and listing (store/PLAY_STORE.md)

Web app

powershell -ExecutionPolicy Bypass -File serve.ps1

then open http://localhost:8000.

Android app

Requirements: Node.js, JDK 21 and Android Studio (Android SDK).

npm install
npm run android          # runs the app on a connected phone or the emulator
npm run android:bundle   # .aab file for Google Play

Signing uses android/keystore.properties and a .jks key, which are never pushed to GitHub.

Translations

All texts live in i18n.js (MESSAGES.fr and MESSAGES.en), and the static texts of index.html are tagged with data-i18n. Fuel names and default units per country are in COUNTRIES. Contributions for new languages or countries are welcome.

License

CarConso is free software released under the GNU GPL v3 (or any later version): you may use, study, modify and share it, as long as modified versions stay under the same license.

Credits

Designed by Atrena, built with help from Claude (Anthropic). Charts: Chart.js (MIT license).

Releases

Sponsor this project

Contributors

Languages