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
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
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.
Versions
0.44.2 Latest Shown above
Published Β· a ready-built bundle
Imported from dannymcc/may at 6918d6ef9087 (v0.44.2).