← Back to Software Projects

CTK Drone Weather

User Manual & Reference Guide

Version 1.3 — For DJI Mini 4 Pro Pilots

Table of Contents

1. Overview

The CTK Drone Weather app is a specialized weather dashboard designed for drone pilots. It provides real-time environmental data—wind, precipitation, UV index, visibility, and more—to help you make informed flight decisions before you take off.

Designed for: DJI Mini 4 Pro and similar consumer drones under 250g.

Unlike standard weather apps, this dashboard uses color-coded safety thresholds tailored specifically for drone operations, making it easy to assess flight conditions at a glance.

2. Quick Start Guide

  1. Launch the app on your Android device.
  2. Grant location permissions when prompted (required for GPS-based weather data).
  3. Enter your API key in the Settings page (see Section 3).
  4. Wait for data to load — the dashboard will populate with live weather data.
  5. Check the Status Bar at the top for your overall flight readiness.
  6. Review individual tiles for detailed conditions.

3. API Key Setup

The app requires API keys to fetch weather data from external services. You only need to enter them once.

1
Open Settings
Tap the gear icon (⚙️) in the app to navigate to the Settings page.
2
Enter your API Key(s)
Paste your API key into the provided text field. You may need keys from OpenWeatherMap and/or CurrentUVIndex.com.
3
Save and Reload
Tap Save API Key. The app will reload and begin fetching data automatically.
Important: If your data shows "Error" on any tile, verify your API key is correct and that you have an active internet connection.

4. API Subscription Data Comparison

The OpenWeatherMap API offers different data depths depending on your subscription tier. Our app is fully functional with the Free tier, but upgrading unlocks additional forecasting tools.

Data Value Free Tier Paid / One Call 3.0
Current Conditions ✅ Available ✅ Available
UV Index ✅ Available ✅ Available
Sunrise / Sunset ✅ Available ✅ Available
Precipitation Rate ✅ Available ✅ Available
Hourly Forecast ❌ Not Available ✅ 24 Hours
Daily Forecast ❌ Not Available ✅ 7-8 Days
Severe Weather Alerts ❌ Not Available ✅ Yes
Historical Data ❌ Not Available ✅ Up to 5 Years

5. Dashboard Tiles

The main screen displays a 3×3 grid of weather tiles. Each tile shows a specific environmental metric with its own color-coded safety indicator.

Tile What It Shows Why It Matters
TMP Current temperature (°F) Affects battery performance and flight time
DEW Dew point (°F) High dew point indicates moisture in the air
FEELS Feels like temperature (°F) Combined effect of temp, wind, and humidity
WIND Wind speed (mph) Critical for drone stability and control
GUST Wind gust speed (mph) Sudden gusts can destabilize your drone
DIR Wind direction (degrees) Helps plan your takeoff/landing heading
VISIBILITY Visibility distance (miles) Lower visibility makes visual line-of-sight harder
CLOUDS Cloud condition (emoji + description) Indicates sky clarity and potential weather changes
PRECIP Precipitation rate (in/hr) Even light rain can damage drone electronics
SUN Sunrise or Sunset time Turns red 30 minutes before sunset as a warning
UV INDEX Current UV index value Indicates sun intensity; affects pilot eye strain
SATS LOCK Number of GPS satellites More satellites = better positioning accuracy

6. Status Bar Guide

The status bar at the top of the dashboard provides an at-a-glance overview of your flight readiness. It uses color-coded indicators to communicate overall conditions:

Green: All conditions are safe for flight. Proceed with confidence.
Yellow: Some conditions are marginal. Review individual tiles for details before deciding.
Red: Conditions are unsafe for flight. Wait for conditions to improve.

7. Wind Speed Thresholds

Wind is the most critical factor for safe drone operations. The app provides color-coded wind speed thresholds:

Green Zone (0–10 mph)

Ideal conditions for all drone types, including the DJI Mini 4 Pro.

Yellow Zone (10–20 mph)

Acceptable for experienced pilots. Expect some turbulence. Secure loose items.

Red Zone (20+ mph)

Not recommended for consumer drones. Strong risk of losing control or crashing.

8. Precipitation Thresholds

Even light rain can damage drone electronics. The app shows precipitation rate in inches per hour:

0.0 in/hr: No precipitation. Safe to fly.
0.01–0.1 in/hr: Light drizzle. Risk of water ingress—fly at your own discretion.
0.1+ in/hr: Moderate to heavy rain. Do not fly. Risk of short circuits and motor failure.

9. UV Index Guide

While UV index doesn't affect your drone directly, it impacts pilot comfort and eye strain during outdoor flights:

0–2 (Low)

No protection needed. Safe for extended outdoor exposure.

3–5 (Moderate)

Wear sunscreen and sunglasses. Take breaks in shade.

6–7 (High)

Reduce midday exposure. Wear protective clothing and hat.

8+ (Very High / Extreme)

Avoid prolonged sun exposure. Seek shade during midday hours.

10. Safety Guidelines

Always prioritize safety when operating drones. Here are key reminders:

11. Troubleshooting

Issue: Data shows "Error" on any tile

Solution: Verify your API key is correct in Settings. Ensure you have an active internet connection. Try saving and reloading the app.

Issue: Weather data is not updating

Solution: Check your location permissions. The app requires location access for GPS-based weather data. Restart the app after granting permissions.

Issue: GPS satellites not locking

Solution: Move to an open area away from tall buildings. Wait 30–60 seconds for satellite lock. More satellites = better accuracy.