SHMU Monitor

About SHMU Weather Grabber

SHMU Weather Grabber is an autonomous, self-hosted weather monitoring, hydrological tracking, and smart home climate analytics portal. It continuously archives official environmental measurements from across Slovakia, integrates personal smart home sensors, and provides high-performance interactive visual analytics.

Data Sources & Attribution

• Official Slovak Weather & River Data: Scraped and parsed directly from the official web portal of the Slovak Hydrometeorological Institute (SHMÚ - Slovenský hydrometeorologický ústav).
• Radar Imagery: Composited 5-minute radar reflectivity frames provided by SHMÚ radar networks, cached and animated locally for smooth playback.
• Personal Sensors: Synced from Google Drive folder (g:\Môj disk\Smarthome TAPO\temperature\) and manual CSV uploads.

Key Features

• Customizable Dashboard: Real-time station tiles with mini-charts, trend indicators, pinning to top, drag-and-drop custom ordering, and River KM sorting.
• In-Depth Detail Analytics: Multi-year historical trends, yearly and monthly views with Prev/Next steppers, interactive date range selector, and single-day 24h drill-downs.
• Radar Animation: Full video-like interactive player with scrubbing slider, play/pause controls, keyboard shortcuts (← / →), and past date archives.
• Autonomous Daemon: Runs continuously in the background, scheduled to fetch new data at your preferred interval (default 15 minutes).
• Secure Remote Access: Built-in Cloudflare Tunnel integration (weather.trusik.link) with read-only security for public visitors, plus zero-config local network sharing for home tablets.
• Data Portability: Every station and the whole database can be exported to standard CSV files at any time.

Architecture & Technology

Custom Locations & Tapo Folder Sync

The Custom Locations module lets you import temperature and humidity records from external sources (such as TP-Link Tapo smart temperature sensors) into your database alongside official SHMU stations.

How Tapo & Google Drive Sync Works

• Automatic Background Sync: The background grabber automatically checks and syncs new files from your Google Drive folder (g:\Môj disk\Smarthome TAPO\temperature\) on every scheduled cycle (default every 15 minutes) and whenever you click "Fetch Now". You never have to manually click sync unless you want an instant refresh!
• Source Directory: Reads directly from:
  g:\Môj disk\Smarthome TAPO\temperature\
• File Naming Conventions (-data matching rule):
  • Everything behind / after -data is treated as the same location file!
  • For example, whether the file is named vnutri-povala-data-2026-09-24.csv, vnutri-povala-data-20260924.csv, or vnutri-povala-data.csv, the system strips everything from -data onwards and assigns all measurements directly into CUSTOM vnutri-povala (povala).
  • Files without -data (such as spalna.csv) have .csv removed and are imported as CUSTOM spalna.
• Station Matching & Merging:
  • If a station named CUSTOM [name] already exists, new measurements from the file are automatically merged into it.
  • If it does not exist, the app automatically registers a new station, marks it as tracked, and populates its initial history.
• Automatic Deduplication:
  • The database table enforces a unique constraint on (location_id, timestamp).
  • During import, an INSERT OR IGNORE statement is executed. If a measurement for that exact station and timestamp already exists, it is safely skipped.
  • You can safely add fresh or overlapping CSVs at any time! Only new timestamp entries will be added.
• Tapo CSV File Format:

  The importer expects the standard Tapo exported format:

  timestamp,temperature,abnormal_temp,humidity,abnormal_humidity
  2026/09/20 00:00:00,18.4,,65,
  2026/09/20 00:01:00,18.5,,64,
  Timestamps in either YYYY/MM/DD HH:MM:SS or ISO YYYY-MM-DD HH:MM:SS are supported. Temperature (°C) is stored as the primary reading and Humidity (%) is saved in metadata.
• Adding Custom Locations Manually: Click "Add Custom Location" to upload any single CSV file directly and assign it a custom name.
• Export CSV: Every custom station can be exported as a full CSV history using the Export action button in the table.

Dashboard & Overview Tiles

The Dashboard displays live sensor cards for all your tracked stations, updated automatically by the background grabber.

• Tile Structure: Each tile shows the station name, measurement type, latest value (with units like cm, °C, mm, and humidity %), and the last update timestamp.
• Expandable Mini-Charts: Click anywhere on a station card to expand or collapse its historical trend graph.
• Toggle All: Click the Toggle All button at the top to simultaneously show or hide graphs on all cards.
• Sort by KM: For river/hydrological stations, groups stations by their river and orders them sequentially according to river kilometer (upstream to downstream).
• Time Range Selector:
  • Last 24h, Last 3 days, Last week: Shows recent fine-grained measurement changes.
  • From beginning - daily: Daily Min and Max values from the earliest recorded measurement to today.
  • From beginning - monthly: Monthly extremes (or monthly total rain).
  • Daily differences: Charts the fluctuation span between maximum and minimum value per day.
• Temperature Degree Color Highlighting: Temperature graph Y-axes highlight critical levels: 0 °C (Frost / Blue), 20 °C (Comfortable / Green), and 30 °C (Hot / Red).

Manage Locations & Tracking

Configure which stations across Slovakia and your smart home are tracked by the background service and shown on your dashboard.

• Tracking Switch: Check the box in the Track column to add a station to your Dashboard. Uncheck to stop displaying it.
• Station Categories:
  • Hydro: Water levels (cm), flow discharge (m³/s), water temperature on Slovak rivers and reservoirs.
  • Meteo: Air temperature (°C), atmospheric pressure, and weather observations.
  • Precip: Hourly and daily rainfall accumulation (mm).
  • Custom: Imported Tapo and external room/outdoor smart home sensors.
• Search & Filters: Filter the table by station type or check "Tracked Only" to focus on your active sensors.
• Rescan SHMU Sources: Fetches the live station catalog from official SHMU web endpoints to discover any newly deployed or renamed stations.

Detail View & Analytics

Deep-dive into the full measurement history, trends, and statistics for any specific station.

• Dropdown Selection: Choose any tracked or untracked station to view its complete historical record.
• Special Modes:
  • From beginning - daily: Renders full-history dual lines for Daily Min and Daily Max values.
  • From beginning - monthly (Weather / Hydro): Shows monthly Min and Max records.
  • From beginning - monthly (Precipitation): Calculates and displays the cumulative monthly precipitation (total mm of rain) alongside the single highest 1-hour rainfall event.
  • Daily differences: Charts the diurnal amplitude (Max - Min difference) to reveal daily volatility.
• Interactive Column Sorting: In the history table, click on any table header (Date, Min, Max, Difference, Total Rain) to sort ascending or descending.
• Right Y-Axis & Colored Degrees: Displays a secondary scale on the right edge of the chart with highlighted color bands for freezing (0 °C), mild (20 °C), and hot (30 °C) conditions.
• Export CSV: Instantly downloads all historical readings for the station in standard comma-separated format.

Meteorological Radar Viewer

Examine animated radar reflectivity imagery to track storm fronts, rain showers, and hail storms across Slovakia.

• Keyboard Shortcuts: Press ← (Left Arrow) to move back one frame and → (Right Arrow) to advance one frame.
• Animation Controls: Click Play to loop through radar frames smoothly. Click Pause to freeze on a specific timestamp.
• Interactive Scrubber: Drag the slider at the bottom to jump to any 5-minute interval throughout the day.
• Historical Date Picker: Use the day dropdown in the header to review radar captures from previous dates.

Settings & System Management

Configure daemon fetch schedules, database exports, and access the application from mobile devices.

• Polling Interval: Sets the cadence (in minutes) at which the background worker retrieves updated figures from SHMU. Default is 15 minutes.
• Local Network Access:
  • The sidebar shows your PC's local Wi-Fi / LAN address (e.g. http://192.168.1.X:5000).
  • Click Copy and paste it into any web browser on your phone, iPad, or wall tablet connected to the same home Wi-Fi to monitor weather anywhere in the house.
• Cloudflare Public Tunnel (Access from Anywhere):
  • In the Settings tab, find the Cloudflare Public Tunnel card and click "Start Public Link".
  • It instantly assigns a free, secure public HTTPS URL (https://*.trycloudflare.com) with zero configuration and no router port forwarding.
  • Read-Only Protection: By default, public visitors browsing over the tunnel can view all cards, details, charts, and radar playback, but modifying actions (deleting stations, importing CSVs, rescanning sources, editing settings) are blocked.
  • Desktop Shortcut: You can also start the tunnel directly from Windows at any time by double-clicking start_tunnel.bat in the root application folder.
• Folder Shortcuts:
  • Export CSV: Exports all recorded measurements across all stations to a single CSV file.
  • Open DB Folder: Opens Windows Explorer to the SQLite database storage folder.
  • Open Radar Folder: Opens the directory containing cached radar PNG images.