🚀 Introduction
MeteoRide loads your GPX/KML route and tells you the weather you will meet on each stretch: temperature, wind, rain, humidity, cloud, light and UV. It works on the web and as an iPhone and Android app.
This help answers "what do I do". The detail —each provider's limits, what is stored and where, how it behaves out of signal— is in the user guide.
🚀 Getting Started
1. Load a GPX/KML route
Press 📁 and pick your file. You can also open MeteoRide with ?gpx_url=, or share the GPX from another app.You can also share the GPX to MeteoRide from another app.
2. Date and time
When you plan to ride. It snaps to 15-minute intervals on its own.
3. Speed
Your estimated average, or a preset: 5, 10, 12, 15 or 20 km/h.
4. Interval
How often you want a reading: every 15 or 30 minutes.
5. Provider
Which source to use, from the ones below. Choose Compare in that list to see the providers side by side over the same route.
6. Compare dates
Press ⇄ next to the date, set Date B and press ⟲. There is no automatic recalculation: if you change anything, press ⟲ again.
🌤️ Weather Providers
- Open-Meteo: no key, global, 14 days. The default, and the right one for almost everything.
- OpenWeather: needs a key, 4 days. Real-time data, and the only one that publishes official alerts.
- AROME-HD: no key, high resolution, France and nearby countries, and 36 hours. Outside that it uses Open-Meteo without you having to do anything.
- OpenWeather → AROME-HD → Open-Meteo: a chain that uses each one over the stretch where it is best. Requires an OpenWeather key.
💡 Tip: if you do not know which to pick, Open-Meteo.
The exact coverage and horizon of each one are in the guide.
🏁 Install as App
The website can be installed as an app (PWA) and gets its own icon, like any other app:
- Android (Chrome) and iPhone/iPad (Safari): menu or Share button → "Add to Home Screen".
- Chrome and Edge on desktop: install icon in the address bar → "Install".
- Safari on Mac: File → "Add to Dock".
The step-by-step recipes for each platform are in the guide.
📱 In the app
Things only the app does.
📤 Sharing routes
With a route loaded, the 📤 button sends it to another app: your head unit, Files, mail. The other way round too: share a GPX from Komoot, Strava or Files and pick MeteoRide. The file never leaves the device.
🔔 Alerts when the weather changes
Once you work out a route, the app keeps watching it and tells you if it turns worse for the hours you will be out: rain appears, wind or strong gusts appear, or an official warning is issued that overlaps your ride. It is on from the start; switch it off under Settings → Alerts → "Tell me if the weather on the route changes".
Worth knowing: the check is run by the operating system, not by the app. On iPhone it needs Background App Refresh.On Android it needs the battery manager not to kill it. When the system is not going to run it, the app says so under the toggle.
🚴 Out of signal
- Opening the app brings back the last route with its table.
- An old forecast is still shown, labelled with how many hours old it is, up to twelve.
- The map background needs a connection and may be blank; the route and the table still show.
The 📴 button saves the forecast for the loaded route and protects it from the automatic clear-out. Press it at home before you leave.
📍 Map and settings
- With no route, the map opens where you are: the system asks for location permission in MeteoRide's name.
- The app starts in the phone's language until you pick one by hand.
- Settings, key and recent routes are still there when you open the app again.
- The phone stays in portrait.
🛠️ Settings
🔑 API key
Only OpenWeather needs a key, and it has to be one for its One Call API 3.0: openweathermap.org/api. The 🔍 Check button next to the field tells you whether it is valid.
📏 Units, language and notices
- Wind in km/h, m/s or mph; temperature in °C or °F; distance in km or mi; rain in mm or in.
- Interface and messages in Spanish or English.
- Show non-critical notices: informational banners when fallbacks happen. Off, you only see critical errors.
📊 Interpreting the Data
🌤️ The table
Each column is a point on the route: time and accumulated distance, weather icon, temperature, wind with gusts in parentheses, rain in mm/h with the probability beside it, humidity and cloud/UV. The vertical bar next to the icon is the light available in that interval.
The rain you see is the rain of the hour you will be riding, not the reading closest to the step's exact minute. When the data source changes, the column is marked OPM (Open-Meteo), ARM (AROME-HD) or OPW (OpenWeather).
🗺️ The map
- Wind arrows: blue light, red strong (30-50 km/h), purple very strong (>50 km/h).
- Droplets 💧: expected precipitation.
- Green and red markers: route start and end.
📱 Advanced Features
🔄 The table scrolls
Drag the table or use the mouse wheel to see more columns; the ⇆ icon says there are some. Pressing a column highlights the row and the map, which recentres on that point.
🌅 Sun and light
Sunrise, sunset and civil twilight, marked with "c", plus the luminosity calculated for each interval.
🎯 Fallbacks
If your provider runs past its horizon, fails or has no data, those steps —only those— are asked of Open-Meteo. Each request gets 15 seconds for the server to start answering and another 15 without receiving data while it downloads; a slow but steady download is never cut. A provider that goes silent is not asked again in that calculation.
🗺️ Recent routes and cache
- Next to 📁 there is a dropdown with the last 5 routes. Re-loading one that was already there moves it to the top of the list.
- They are stored on your device and never shared. Up to about 750 KB per GPX.
- Provider responses are cached for about 30 minutes and expire on their own.
🔗 URLs with parameters
?gpx_url=https://example.com/route.gpx?datetime=2024-03-15T10:00?speed=25
⚠️ Limitations and Tips
🚨 Limits
- Horizon: Open-Meteo 14 days, OpenWeather 4 days, AROME-HD 36 hours.
- From day 3-4 onwards the forecast is markedly less reliable.
- OpenWeather keys have usage limits set by OpenWeather; Open-Meteo needs no key at all.
✅ Tips
- Routes of 100-200 km at most, and plan 1-2 days ahead.
- Cross-check several sources when the decision matters.
- Have a plan B and carry rain gear even if the probability is low.
🚨 Official Weather Alerts
MeteoRide can show the official warnings issued by national meteorological services. Only OpenWeather publishes them: put your key in Settings and tick Show official weather alerts. Without a key the checkbox is disabled and says why.
- They are checked even when OpenWeather is not your primary provider.
- An alert appears as a card, which hides itself, and leaves a ⚠️ to re-open them.
- Only the ones overlapping the time you will be on that stretch are taken into account.
⚠️ Important notice
They are extra information, not a source of safety. Always check your country's official meteorological service before a ride that could be affected: OpenWeather may contain errors, delays, or omit local warnings. MeteoRide does not replace official communications.
🐛 Troubleshooting
- The GPX/KML will not load: check that the file contains valid tracks.
- No weather data: check the key with 🔍 Check, or switch to Open-Meteo, which needs none.
- Date out of range: bring the date closer; each provider has its own horizon.
- Empty table: the route is too short for even one step.
🔒 Privacy and Data
🛡️ Your data stays with you
MeteoRide runs on your device: settings, routes and cache are stored only there, with no account and no sign-up. The exception is the website with the iOS Shortcuts, which upload the GPX to Cloudflare because Shortcuts only accept POST; that file is deleted within two minutes at most.
🌐 What is sent to the providers
- The coordinates of your route and the times you are asking a forecast for.
- Your OpenWeather key, if you use one. It is stored unencrypted, so a key used for nothing else is wise — or none at all, with Open-Meteo and AROME-HD.
The providers have their own privacy policies. Exactly what is stored on your device is in the guide.
The full detail — what each provider receives, how long it keeps it, and how to delete everything left on the device — is in the privacy policy.
📄 License and Credits
MeteoRide is developed by Lockevod under the MIT license: you may use it, modify it and distribute it, for personal or commercial use, naming the author and the license.
🙏 Technologies
Maps from OpenStreetMap, data from Open-Meteo and OpenWeather, icons from Weather Icons (Erik Flowers), Leaflet.js, SunCalc and GPX parser, native app with Capacitor and the website on Cloudflare Pages.
⚖️ Disclaimer
Weather data from Open-Meteo are licensed under CC BY 4.0. MeteoRide samples the forecast along the route, converts units and computes summaries and comparisons. These are MeteoRide's calculations, not an endorsement by the data provider.
Open-Meteo, OpenWeather and OpenStreetMap, and the route sites this website can open (Komoot, Bikemap, Hammerhead), are marks of their owners, with their own terms, which you must comply with. MeteoRide is provided as-is, without warranty or liability, and you accept that by using it. MeteoRide is a planning tool: weather data are estimates, so verify conditions before heading out and use your judgement.
The full terms and the updated information are on GitHub and in the guide.
📞 Support and Contributions
🐛 Report Issues
- Write to support@meteoride.cc, or open an issue in the GitHub repository
- Turn the debug button (🐞) on under Settings → Show debug button: it starts off
- Include your device and the version, shown at the foot of this page
🤝 Contribute to the Project
Fork the repository, report bugs, suggest improvements, translate to new languages or improve the documentation.
💡 Final tip: Weather can change quickly! Use MeteoRide as a guide, but stay flexible and safe on your rides.
💰 Support the Project
If you find MeteoRide useful, consider supporting the project with a donation:
