ion

All web apps in the Catalogue

May

by dannymcc Β· io.github.dannymcc.may

Not TrustedWeb appUnratedβ˜… 258 stars

May is a web-based dashboard application that gives you a neat and clean…

May is a web-based dashboard application that gives you a neat and clean interface for logging your fuel fill-ups for all of your vehicles. The application has full multi-user support, as well as multiple vehicles per user. Whenever you fill-up your car or motorcycle, keep the receipt and record the data in May.

Screenshots

  • Dashboard
    Dashboard
  • Vehicles
    Vehicles
  • Vehicle Details
    Vehicle Details
  • Integrations
    Integrations
  • Import/Export
    Import/Export

About

A modern, self-hosted vehicle management application for tracking fuel consumption, expenses, reminders, and maintenance across your entire fleet. Named after James May, completing the trio of Top Gear presenters (alongside Clarkson and Hammond). - πŸš— Multi-Vehicle Support: Track cars, vans, motorbikes, and scooters with custom vehicle types - β›½ Fuel Logging: Record fill-ups with automatic consumption calculations (L/100km, MPG) and optional sales tax totals by year - ⚑ Quick Entry Mode: Rapid fuel logging with a streamlined interface - πŸ’° Expense Tracking: Monitor maintenance, insurance, repairs, tax, and other costs by category - πŸ”„ Recurring Expenses: Track regular payments like insurance, tax, and subscriptions - 🧭 Trip Logging: Log journeys for mileage and tax records, with optional fuel gauge readings for a per-trip view of consumption - πŸ”§ Maintenance Schedules: Plan and track scheduled maintenance with mileage, engine-hour or date intervals - πŸ›ž Tire Sets: Record each set of tires going on and off the vehicle, with the distance covered per set worked out for you - πŸ“… Reminders: Set up recurring reminders for MOT, service, insurance, and tax renewals - πŸ”” Multi-Channel Notifications: Get reminded via Email, ntfy, Pushover, or Webhooks - πŸ“ Document Storage: Store important documents (insurance, registration, manuals) per vehicle - β›½ Favorite Stations: Save and quickly select your preferred fuel stations - πŸ‘₯ Multi-User: Share vehicles between family members or team members - πŸ” User Roles: Give each account full access, fuel-and-charging only, or read-only - πŸ“Š Analytics Dashboard: View spending trends and consumption statistics with interactive charts - πŸ“Ž Attachment Support: Upload receipts and documents to fuel logs and expenses - πŸ“„ PDF Reports: Generate comprehensive vehicle reports for record-keeping, optionally with receipt images attached - πŸ”§ Customizable Units: Support for metric/imperial, multiple currencies - πŸŽ›οΈ Menu Customization: Show/hide menu items and set your preferred start page - 🌍 Internationalization: Available in multiple languages (English, German, Spanish, French, and more) - 🎨 Custom Branding: Personalize with your own logo, colors, and app name - πŸŒ™ Dark Mode: Toggle between light and dark themes - πŸ“₯ Import/Export: Restore a May backup (JSON export or full ZIP) into another instance, import from Fuelly CSV, export all data as JSON or CSV - πŸ‡¬πŸ‡§ DVLA Integration: Look up UK vehicle MOT and tax status automatically - β›½ UK Fuel Prices: Pull live forecourt prices for your saved UK stations from the government fuel price feeds, no API key needed - πŸ“± PWA Support: Install as a mobile app with offline capabilities - πŸ”Œ REST API: Full API access for integrations and automation - 🏠 Home Assistant Integration: Create sensors and automations for your vehicles - πŸ“† Calendar Subscription: Subscribe to reminders in Apple Calendar, Google Calendar, Outlook - 🐳 Docker Ready: Easy self-hosting via Docker Sign-in: this app keeps its own accounts. Each member signs up or signs in inside the app with an app username and password; the hub remembers each member's session. First account: made when the app is installed (admin) from the variables it reads at start (ADMIN_PASSWORD), with a password the hub generates; the hub's owner reads it on the app's Access tab. May is the open-source project dannymcc/may (https://github.com/dannymcc/may) by dannymcc, released under MIT. Ion packages it unmodified from commit 6918d6ef9087, adding only a manifest, an icon and a start script.

Source

Written by dannymcc, published to Oikou by Ben Grande.

  • β˜… 258 stars on GitHub
  • Licence: MIT
  • Upstream version v0.44.2
  • Built from commit 6918d6ef9087

View the repository on GitHub

Age rating

Not rated. Nobody has said who this app is suitable for, so Personal Clouds and the Oikou app treat it as 18+.

What version 0.44.2 may do

Internet

It asks to reach these hosts, and no others:

  • cdn.jsdelivr.net
  • cdn.tailwindcss.com
  • ntfy.sh
  • pushover.net
  • developer-portal.driver-vehicle-licensing.api.gov.uk
  • tessie.com
  • www.gov.uk

Personal Cloud tools

  • Keep a database of its own on your Personal Cloud ion.db

Notifications

It does not send push notifications.

Storage

Up to 512 MB on your Personal Cloud.

Sign-in details your Personal Cloud makes

The Personal Cloud makes a sign-in password for this app when it is installed. Only you can read it, on the app’s Access tab on your Personal Cloud. Oikou never sees it.

  • admin-password β€” The password of May's first administrator account, made when the app was installed (account: admin)

Its address

Works best with its own address. A Personal Cloud shared through Cloudflare can give it one; on a private Personal Cloud on Tailscale it opens under your Personal Cloud’s address, where it may not work fully. Private and shared Personal Clouds

Add to Personal Cloud

Sign in to add this web app to a Personal Cloud of yours. It runs there, on your own computer, and you open it from there; nothing is installed on your phone.

Sign in to add

Versions

0.44.2 Latest Shown above

Published Β· a ready-built bundle

Imported from dannymcc/may at 6918d6ef9087 (v0.44.2).

Report this app