Help & Documentation

Quick Start - Terminal/API

Get weather data directly from your terminal. No API key required!

Current Weather: curl https://wthr.top/London
One-Line Format: curl "https://wthr.top/Paris?format=3"
Moon Phase: curl https://wthr.top/moon
JSON API: curl https://wthr.top/api/v1/weather?location=Tokyo
Earthquakes: curl https://wthr.top/api/v1/earthquakes?feed=all_day
Severe Weather: curl https://wthr.top/api/v1/severe-weather?location=Miami

Getting Started

How do I get weather for my location?

Simply enter a city name, ZIP code, or coordinates in the search box on the homepage. You can also click "My Location" to auto-detect your position using GPS or IP geolocation.

Supported location formats:

  • City name: London, New York
  • City with state/country: Paris, France, Albany, NY
  • ZIP/Postal code: 10001, SW1A 1AA
  • Coordinates: 40.7128,-74.0060
How do I create an account?

Click the user icon in the top right corner and select "Register". Fill in your email, username, and password. After registering, you can save up to 10 favorite locations and subscribe to weather alerts.

How do I enable weather alerts?

From your dashboard, add a location and enable "Weather Alerts". You'll receive notifications for severe weather affecting that location via WebSocket push or email (if configured).

Features

Weather Forecasts

Get 16-day forecasts with hourly and daily breakdowns:

  • Current conditions - temperature, humidity, wind, pressure
  • 48-hour hourly forecast
  • 16-day daily forecast
  • Precipitation probability and amounts
  • UV index and feels-like temperature

Data from Open-Meteo, updated every 15 minutes.

Severe Weather Alerts

The Severe Weather page shows real-time alerts from:

  • 🇺🇸 USA - NOAA Weather API
  • 🇨🇦 Canada - Environment Canada
  • 🇬🇧 UK - Met Office
  • 🇦🇺 Australia - Bureau of Meteorology
  • 🇯🇵 Japan - JMA
  • 🇲🇽 Mexico - CONAGUA

Filter by type (hurricanes, tornadoes, storms, winter, floods) and distance. Alerts updated every 5 minutes.

Hurricane Tracking

Monitor active tropical storms and hurricanes from NOAA National Hurricane Center. Track storm position, wind speed, pressure, movement, and forecast path.

Earthquake Monitoring

The Earthquake page shows real-time seismic activity from USGS:

  • Filter by time range (hour, day, week, month)
  • Filter by magnitude (all, M4.5+, significant)
  • View tsunami warnings
  • Interactive map with earthquake markers
  • Search by location to find nearby earthquakes

Data updated every minute.

Moon Phase Tracking

The Moon page shows:

  • Current phase (new, waxing crescent, first quarter, etc.)
  • Illumination percentage
  • Days since new moon
  • Moonrise and moonset times for your location

Calculated internally - no external API needed.

API Access

API Endpoints

All endpoints available at /api/v1/:

  • GET /api/v1/weather?location=CITY - Current weather and forecast
  • GET /api/v1/earthquakes?feed=all_day - Earthquake data
  • GET /api/v1/severe-weather?location=CITY - Severe weather alerts
  • GET /api/v1/hurricanes - Active hurricanes
  • GET /api/v1/moon?location=CITY - Moon phase data
  • GET /api/v1/search?q=QUERY - Location search
  • GET /server/healthz - Health check

Visit /docs for full API documentation.

Do I need an API key?

No API key required for public endpoints. All weather data sources are free/public APIs.

If you have an account, you can generate API tokens from your settings page for authenticated access with higher rate limits.

Rate Limits
  • Anonymous: 120 reads and 10 writes per minute, per IP address
  • Authenticated: 120 reads and 10 writes per minute, per token
  • Admin: The same limits, per token (operators can change the values)

Check response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Response Formats

Set the Accept header to control response format:

  • Accept: application/json - JSON response
  • Accept: text/plain - Plain text (for terminal)
  • Accept: text/html - HTML page (default for browsers)

GraphQL endpoint available at /server/docs/graphql. Supports POST with

GraphQL API

Send queries and mutations to POST /api/v1/server/graphql with a JSON body of the form {"query": "...", "variables": {...}}.

Key Queries

  • weather(location: String!) - Current weather and forecast
  • currentUser - Authenticated user profile
  • savedLocations - User's saved locations
  • userTokens - API tokens for authenticated user
  • userPasskeys - Registered passkeys for authenticated user
  • publicUserProfile(username: String!) - Public user profile

GraphQL is read-only (queries only). Every write operation, such as signing in, changing settings or managing passkeys, uses the REST API; see the API documentation.

Full schema introspection available via POST /graphql with a standard introspection query, or visit the GraphQL playground.

Troubleshooting

Weather data isn't loading
  • Refresh the page (F5 or Ctrl+R)
  • Verify the location name is correct
  • Try coordinates instead of city name
  • Check /server/healthz for server status
Location detection not working
  • Allow location access in your browser when prompted
  • If GPS fails, the system will fall back to IP-based detection
  • You can always enter your location manually
I forgot my password

Click "Forgot Password" on the login page. Enter your email address and we'll send you a password reset link.

Privacy & Security

What data do you collect?

See our Privacy Policy. We collect minimal data: account information (if registered), saved locations, and usage logs for security.

How do I delete my account?

Go to your settings page and click "Delete Account". This action is permanent.

Still Need Help?