diff --git a/README.md b/README.md index 3c446dc..6831291 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ The API is deliberately well-defined with an OpenAPI specification and auto-gene Spothole itself is also open source, Public Domain licenced code that anyone can take and modify. -Supported data sources include DX Clusters, the Reverse Beacon Network (RBN), the APRS Internet Service (APRS-IS), POTA, SOTA, WWFF, GMA, WWBOTA, HEMA, Parks 'n' Peaks, ZLOTA, WOTA, BOTA, LLOTA, WWTOTA, the UK Packet Repeater Network, NG3K, and any site based on the xOTA software by nischu. +Supported data sources include DX Clusters, the Reverse Beacon Network (RBN), the APRS Internet Service (APRS-IS), POTA, SOTA, WWFF, GMA, WWBOTA, HEMA, Parks 'n' Peaks, ZLOTA, WOTA, BOTA, LLOTA, WWTOTA, Tiles on the Air, the UK Packet Repeater Network, NG3K, and any site based on the xOTA software by nischu. ![Screenshot](/images/screenshot2.png) diff --git a/config-example.yml b/config-example.yml index 43b816a..9a4e0c4 100644 --- a/config-example.yml +++ b/config-example.yml @@ -60,6 +60,10 @@ spot-providers: class: "WWTOTA" name: "WWTOTA" enabled: true + - + class: "Tiles" + name: "Tiles" + enabled: true - class: "APRSIS" name: "APRS-IS" diff --git a/core/constants.py b/core/constants.py index 72d7fe5..703fb66 100644 --- a/core/constants.py +++ b/core/constants.py @@ -30,6 +30,7 @@ SIGS = [ SIG(name="KRMNPA", description="Keith Roget Memorial National Parks Award"), SIG(name="LLOTA", description="Lagos y Lagunas on the Air", ref_regex=r"[A-Z]{2}\-\d{4}"), SIG(name="WWTOTA", description="Towers on the Air", ref_regex=r"[A-Z]{2}R\-\d{4}"), + SIG(name="Tiles", description="Tiles on the Air", ref_regex=r"[A-Za-z]{2}[0-9]{2}[A-Za-z]{2}"), SIG(name="WAB", description="Worked All Britain", ref_regex=r"[A-Z]{1,2}[0-9]{2}"), SIG(name="WAI", description="Worked All Ireland", ref_regex=r"[A-Z][0-9]{2}"), SIG(name="TOTA", description="Toilets on the Air", ref_regex=r"T\-[0-9]{2}") diff --git a/core/sig_utils.py b/core/sig_utils.py index 7e02303..f1cb429 100644 --- a/core/sig_utils.py +++ b/core/sig_utils.py @@ -143,6 +143,16 @@ def populate_sig_ref_info(sig_ref): if not sig_ref.name: sig_ref.name = sig_ref.id sig_ref.url = "https://wwtota.com/seznam/karta_rozhledny.php?ref=" + sig_ref.name + elif sig.upper() == "TILES": + # Tiles on the Air just uses Maidenhead 6-digit squares, so ID, Name and Grid are all the same + if not sig_ref.name: + sig_ref.name = sig_ref.id + if not sig_ref.grid: + sig_ref.grid = sig_ref.id + if sig_ref.grid and not sig_ref.latitude: + ll = locator_to_latlong(sig_ref.grid) + sig_ref.latitude = ll[0] + sig_ref.longitude = ll[1] elif sig.upper() == "WAB" or sig.upper() == "WAI": ll = wab_wai_square_to_lat_lon(ref_id) if ll: diff --git a/spotproviders/tiles.py b/spotproviders/tiles.py new file mode 100644 index 0000000..406af8c --- /dev/null +++ b/spotproviders/tiles.py @@ -0,0 +1,50 @@ +from datetime import datetime + +from data.sig_ref import SIGRef +from data.spot import Spot +from spotproviders.http_spot_provider import HTTPSpotProvider + + +class Tiles(HTTPSpotProvider): + """Spot provider for Tiles on the Air""" + + POLL_INTERVAL_SEC = 120 + SPOTS_URL = "https://icneuzxitdqtofutxbla.supabase.co/functions/v1/spots?active_hours=24" + + def __init__(self, provider_config): + super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC) + + def _http_response_to_spots(self, http_response): + new_spots = [] + # Iterate through source data + for source_spot in http_response.json()["spots"]: + # Convert to our spot format + spot = Spot(source=self.name, + source_id=source_spot["id"], + dx_call=source_spot["call_sign"].upper(), + # No separate spotter callsign, assume all spots are self-spots + de_call=source_spot["call_sign"].upper(), + freq=float(strip_extra_decimal_points(source_spot["frequency"])) * 1000000, + mode=source_spot["mode"].upper(), + comment=source_spot["notes"], + sig="Tiles", + # Tiles spots can include POTA & SOTA references, but ignore those on the basis that we will get them separately from the POTA/SOTA providers anyway. + # Just take the grid reference itself as the single Tiles SIG reference. + sig_refs=[SIGRef(id=source_spot["maidenhead_grid"], sig="Tiles", name=source_spot["maidenhead_grid"])], + time=datetime.fromisoformat(source_spot["created_at"].replace("Z", "+00:00")).timestamp(), + dx_grid=source_spot["maidenhead_grid"], + dx_latitude=source_spot["latitude"], + dx_longitude=source_spot["longitude"]) + + # Add to our list. Don't worry about de-duping, removing old spots etc. at this point; other code will do + # that for us. + new_spots.append(spot) + return new_spots + +# Utility function to keep the first decimal point in a given string but remove any others. Used to parse Tiles' +# strange frequency format where we can sometimes have e.g. "14.123.5". +def strip_extra_decimal_points(s): + parts = s.split('.', 1) + if len(parts) == 1: + return s + return parts[0] + '.' + parts[1].replace('.', '') \ No newline at end of file diff --git a/spotproviders/wota.py b/spotproviders/wota.py index cfe4a46..0af0760 100644 --- a/spotproviders/wota.py +++ b/spotproviders/wota.py @@ -47,7 +47,7 @@ class WOTA(HTTPSpotProvider): desc_split = source_spot.description.split(". ") freq_mode = desc_split[0].replace("Frequencies/modes:", "").strip() freq_mode_split = re.split(r'[\-\s]+', freq_mode) - freq_hz = float(freq_mode_split[0]) * 1000000 + freq_hz = float(freq_mode_split[0].replace("'",".")) * 1000000 mode = None if len(freq_mode_split) > 1: mode = freq_mode_split[1].upper() diff --git a/templates/about.html b/templates/about.html index 98486e6..658e264 100644 --- a/templates/about.html +++ b/templates/about.html @@ -25,11 +25,11 @@

What are "DX", "DE" and modes?

In amateur radio terminology, the "DX" contact is the "interesting" one that is using the frequency shown and looking for callers. They might be on a remote island or just in a local park, but either way it's interesting enough that someone has "spotted" them. The callsign listed under "DE" is the person who entered the spot of the "DX" operator. "Modes" are the type of communication they are using. For example you might see "CW" which is Morse Code, or voice "modes" like SSB or FM, or more exotic "data" modes which are used for computer-to-computer communication.

What data sources are supported?

-

Spothole can retrieve spots from: Telnet-based DX clusters, the Reverse Beacon Network (RBN), the APRS Internet Service (APRS-IS), POTA, SOTA, WWFF, GMA, WWBOTA, HEMA, Parks 'n' Peaks, ZLOTA, WOTA, LLOTA, WWTOTA, the UK Packet Repeater Network, and any site based on the xOTA software by nischu.

+

Spothole can retrieve spots from: Telnet-based DX clusters, the Reverse Beacon Network (RBN), the APRS Internet Service (APRS-IS), POTA, SOTA, WWFF, GMA, WWBOTA, HEMA, Parks 'n' Peaks, ZLOTA, WOTA, LLOTA, WWTOTA, Tiles on the Air, the UK Packet Repeater Network, and any site based on the xOTA software by nischu.

Spothole can retrieve alerts from: NG3K, POTA, SOTA, WWFF, Parks 'n' Peaks, WOTA and BOTA.

Spothole can retrieve solar and propagation condition data from HamQSL.

Note that the server owner has not necessarily enabled all these data sources. In particular it is common to disable RBN, to avoid the server being swamped with FT8 traffic, and to disable APRS-IS and UK Packet Net so that the server only displays stations where there is likely to be an operator physically present for a QSO.

-

Between the various data sources, the following Special Interest Groups (SIGs) are supported: Parks on the Air (POTA), Summits on the Air (SOTA), Worldwide Flora & Fauna (WWFF), Global Mountain Activity (GMA), Worldwide Bunkers on the Air (WWBOTA), HuMPs Excluding Marilyns Award (HEMA), Islands on the Air (IOTA), Mills on the Air (MOTA), the Amateur Radio Lighthouse Socirty (ARLHS), International Lighthouse Lightship Weekend (ILLW), Silos on the Air (SIOTA), World Castles Award (WCA), New Zealand on the Air (ZLOTA), Keith Roget Memorial National Parks Award (KRMNPA), Wainwrights on the Air (WOTA), Beaches on the Air (BOTA), Lagos y Lagunas On the Air (LLOTA), Towers on the Air (WWTOTA), Worked All Britain (WAB), Worked All Ireland (WAI), and Toilets on the Air (TOTA).

+

Between the various data sources, the following Special Interest Groups (SIGs) are supported: Parks on the Air (POTA), Summits on the Air (SOTA), Worldwide Flora & Fauna (WWFF), Global Mountain Activity (GMA), Worldwide Bunkers on the Air (WWBOTA), HuMPs Excluding Marilyns Award (HEMA), Islands on the Air (IOTA), Mills on the Air (MOTA), the Amateur Radio Lighthouse Socirty (ARLHS), International Lighthouse Lightship Weekend (ILLW), Silos on the Air (SIOTA), World Castles Award (WCA), New Zealand on the Air (ZLOTA), Keith Roget Memorial National Parks Award (KRMNPA), Wainwrights on the Air (WOTA), Beaches on the Air (BOTA), Lagos y Lagunas On the Air (LLOTA), Towers on the Air (WWTOTA), Tiles on the Air, Worked All Britain (WAB), Worked All Ireland (WAI), and Toilets on the Air (TOTA).

As of the time of writing in November 2025, I think Spothole captures essentially all outdoor radio programmes that have a defined reference list, and almost certainly those that have a spotting/alerting API. If you know of one I've missed, please let me know!

Why can I filter spots by both SIG and Source? Isn't that basically the same thing?

Mostly, but not quite. While POTA spots generally come from the POTA source and so on, there are a few exceptions:

@@ -67,7 +67,7 @@

This software is dedicated to the memory of Tom G1PJB, SK, a friend and colleague who sadly passed away around the time I started writing it in Autumn 2025. I was looking forward to showing it to you when it was done.

- + {% end %} \ No newline at end of file diff --git a/templates/add_spot.html b/templates/add_spot.html index 03e69c6..134f741 100644 --- a/templates/add_spot.html +++ b/templates/add_spot.html @@ -69,8 +69,8 @@ - - + + {% end %} \ No newline at end of file diff --git a/templates/alerts.html b/templates/alerts.html index 1e7b3e7..bd8ce68 100644 --- a/templates/alerts.html +++ b/templates/alerts.html @@ -56,8 +56,8 @@ - - + + {% end %} \ No newline at end of file diff --git a/templates/bands.html b/templates/bands.html index 6ea2bb7..c637882 100644 --- a/templates/bands.html +++ b/templates/bands.html @@ -62,9 +62,9 @@ - - - + + + {% end %} \ No newline at end of file diff --git a/templates/base.html b/templates/base.html index e01fe69..11e9059 100644 --- a/templates/base.html +++ b/templates/base.html @@ -24,7 +24,7 @@ Spothole - + @@ -46,9 +46,9 @@ crossorigin="anonymous"> - - - + + + diff --git a/templates/conditions.html b/templates/conditions.html index 52f9f1e..e3c9695 100644 --- a/templates/conditions.html +++ b/templates/conditions.html @@ -230,8 +230,8 @@ - - + + diff --git a/templates/map.html b/templates/map.html index 1d10a23..712b328 100644 --- a/templates/map.html +++ b/templates/map.html @@ -79,9 +79,9 @@ - - - + + + {% end %} \ No newline at end of file diff --git a/templates/spots.html b/templates/spots.html index 3cc8b20..217e101 100644 --- a/templates/spots.html +++ b/templates/spots.html @@ -90,9 +90,9 @@ - - - + + + {% end %} \ No newline at end of file diff --git a/templates/status.html b/templates/status.html index 93ef48c..14bc6ee 100644 --- a/templates/status.html +++ b/templates/status.html @@ -59,8 +59,8 @@ - - + + diff --git a/webassets/apidocs/openapi.yml b/webassets/apidocs/openapi.yml index c95885b..c249265 100644 --- a/webassets/apidocs/openapi.yml +++ b/webassets/apidocs/openapi.yml @@ -853,6 +853,7 @@ components: - WOTA - LLOTA - WWTOTA + - Tiles - Cluster - RBN - APRS-IS @@ -880,6 +881,7 @@ components: - BOTA - LLOTA - WWTOTA + - Tiles - WAB - WAI - TOTA @@ -906,6 +908,7 @@ components: - BOTA - LLOTA - WWTOTA + - Tiles - WAB - WAI - TOTA