diff --git a/README.md b/README.md index 53f04eb..196baf2 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# ![Spothole](/static/img/logo.png) +# ![Spothole](https://git.ianrenton.com/ian/spothole/raw/branch/main/static/img/logo.png) Spothole is a utility to aggregate "spots" from amateur radio DX clusters and xOTA spotting sites, and provide an open JSON API as well as a website to browse the data, and its own telnet server for integration with desktop loggers. @@ -17,42 +17,25 @@ individual data source presents its data. 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, Tiles on the Air, the UK Packet -Repeater Network, NG3K, and any site based on the xOTA software by nischu. It also integrates with QRZ.com and HamQTH, -retrieves solar data from various sources, provides information about upcoming contests, and more. - -You can read more about Spothole on [the "About" page of the main server instance](https://spothole.app/about). +You can read more about Spothole on [the "Help" pages of the main server instance](https://spothole.app/help). ![Screenshot](/images/screenshot2.png) -![Screenshot](/images/screenshot3.png) - ## Accessing the public version You can access the public version's web interface at [https://spothole.app](https://spothole.app), and see [https://spothole.app/apidocs](https://spothole.app/apidocs) for the API details. -This is a Progressive Web App, so you can also "install" it to your Android or iOS device by accessing it in Chrome or -Safari respectively, and following the menu-driven process for installing PWAs. - You are more than welcome to use the data and the API that Spothole provides to power your own software, to run your own -Spothole server, or to modify it in any way. More details can be found in the following sections: +Spothole server, or to modify it in any way. More details can be found +in [the "Help" pages of the main server instance](https://spothole.app/help). -* [Embedding Spothole in another website](docs/embedding.md) -* [Writing your own client](docs/clients.md) -* [Running your own copy](docs/running.md) - * [nginx reverse proxy configuration](docs/nginx.md) - * [systemd service file](docs/systemd.md) - * [Running in Docker](docs/docker.md) - * [Use of multiple cluster logins](docs/multicluster.md) -* [Modifying the source code](docs/modifying.md) - -![Screenshot](/images/screenshot4.png) +![Screenshot](/images/screenshot3.png) ## Thanks -[Spothole's "About" page](https://spothole.app/about) contains the full details of the thanks I owe to the various +[Spothole's "Thanks" page](https://spothole.app/help/thanks) contains the full details of the thanks I owe to the +various programme teams, software library providers, bug fixers etc. The extra detail below contains the extra detail of specific files in this repository which are not all my own work and may be subject to other licences. diff --git a/templates/add_spot.html b/templates/add_spot.html index 7084e4b..c01a2b1 100644 --- a/templates/add_spot.html +++ b/templates/add_spot.html @@ -77,7 +77,7 @@ - + diff --git a/templates/alerts.html b/templates/alerts.html index 5316ccd..e560d9d 100644 --- a/templates/alerts.html +++ b/templates/alerts.html @@ -85,7 +85,7 @@ - + diff --git a/templates/bands.html b/templates/bands.html index d70c731..ec27235 100644 --- a/templates/bands.html +++ b/templates/bands.html @@ -76,8 +76,8 @@ - - + + diff --git a/templates/base.html b/templates/base.html index 73ea54b..3ad1f56 100644 --- a/templates/base.html +++ b/templates/base.html @@ -1,6 +1,6 @@ {% extends "skeleton.html" %} {% block head_extra %} - + @@ -16,10 +16,10 @@ window.fetchEventSource = fetchEventSource; - - - - + + + + {% end %} {% block body %}
diff --git a/templates/conditions.html b/templates/conditions.html index 3292749..66c6982 100644 --- a/templates/conditions.html +++ b/templates/conditions.html @@ -284,7 +284,7 @@
- + diff --git a/templates/help/faq.html b/templates/help/faq.html index 316d479..69f521d 100644 --- a/templates/help/faq.html +++ b/templates/help/faq.html @@ -1,7 +1,7 @@ {% extends "help_page.html" %} {% block help_content %} -

FAQ

+

Frequently Asked Questions (FAQ)

"Spots"? "DX Clusters"? What does any of this mean?

This is a tool for amateur ("ham") radio users. Many amateur radio operators like to make contacts with others who are doing something more interesting than sitting in their home "shack", such as people in rarely-seen @@ -21,48 +21,6 @@ "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, 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. It also fetches contest dates from - WA7BNM Contest Calendar and RSGB contest calendars.

-

Spothole can retrieve solar and propagation condition data from HamQSL, the - NOAA Space Weather Prediction Center, the Lowell GIRO Data Center and prop.kc2g.com - by KC2G.

-

Spothole can also perform lookups for callsign data on behalf of the user from QRZ.com and HamQTH.

-

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 activities / special interest groups are supported: Contests, - DXpeditions, Aeronautical Mobile, Maritime Mobile, EME/Moonbounce, Amateur Satellite, QRP, 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 Society (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), South Australia National Parks and Conservation Parks Award (SANPCPA), Wainwrights on the - Air (WOTA), Beaches on the Air (BOTA), Lagos y Lagunas On the Air (LLOTA), Towers on the Air, Tiles on - the Air, Worked All Britain (WAB), Worked All Ireland (WAI), Diploma Municipios de España (DME), Diploma - Faros de España (FEA), Diploma Muesos de España (DMUE), Diploma Castillos de España (DCE), Diploma Monumentos y - Vestigios de España (DMVE), Diploma Estaciones de Ferrocarril de España (DEFE), Diploma Teatri Musei e Belle - Arti (DTMBA), British Inland Waterways on the Air (BIWOTA), Castles on the Air (COTA), Polish Gmina Award (PGA), - Diplôme des Moulins de France (DMF), RaDAR Rally, and Toilets on the Air.

-

As of the time of writing in August 2026, I think Spothole captures most radio programmes that have a - defined, downloadable 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 Activity 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:

diff --git a/templates/help/help_page.html b/templates/help/help_page.html index 975e0f3..9c6f780 100644 --- a/templates/help/help_page.html +++ b/templates/help/help_page.html @@ -2,9 +2,9 @@ {% block content %}
-

Spothole Help

+

« Spothole Help

{% block help_content %}{% end %} -

Back

+

« Back

- - + + diff --git a/templates/spots.html b/templates/spots.html index b06328d..ab35dfd 100644 --- a/templates/spots.html +++ b/templates/spots.html @@ -125,8 +125,8 @@ - - + + diff --git a/templates/status.html b/templates/status.html index 74f0329..abb3104 100644 --- a/templates/status.html +++ b/templates/status.html @@ -96,7 +96,7 @@ - +