diff --git a/views/webpage_about.tpl b/views/webpage_about.tpl index 959435d..5a4153a 100644 --- a/views/webpage_about.tpl +++ b/views/webpage_about.tpl @@ -1,14 +1,33 @@ % rebase('webpage_base.tpl')
-

About Spothole

+

About Spothole

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.

While there are several other web-based interfaces to DX clusters, and sites that aggregate spots from various outdoor activity programmes for amateur radio, Spothole differentiates itself by supporting a large number of data sources, and by being "API first" rather than just providing a web front-end. This allows other software to be built on top of it.

The API is deliberately well-defined with an OpenAPI specification and auto-generated API documentation. The API delivers spots in a consistent format regardless of the data source, freeing developers from needing to know how each individual data source presents its data.

Spothole itself is also open source, Public Domain licenced code that anyone can take and modify. The source code is here. If you want to run your own copy of Spothole, or start modifying it for your own purposes, the README file contains a description of how the software works and how it's laid out, as well as instructions for configuring systemd, nginx and anything else you might need to run your own server.

Supported data sources include DX Clusters, the Reverse Beacon Network (RBN), the APRS Internet Service (APRS-IS), POTA, SOTA, WWFF, GMA, WWBOTA, HEMA, and Parks 'n' Peaks.

The software was written by Ian Renton, MØTRT and other contributors. Full details are available in the README.

-

« Back home

+

FAQ

+

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

+

This is a tool for amateur, or "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 countries, remote islands, or on mountaintops. Such operators are often "spotted", i.e. when someone speaks to them, they will put the details such as their operating frequency into an online system, to let others know where to find them. A DX Cluster is one type of those systems. Most outdoor radio awards programmes, such as "Parks on the Air" (POTA) have their own websites for posting spots.

+

Spothole is an "aggregator" for those spots, so it checks lots of different services for data, and brings it all together in one place.

+

As well as spots, it also provides a similar feed of "alerts". This is where amateur radio users who are going to interesting places soon will announce their intentions.

+

How is this better than DXheat, DXsummit, POTA's own website, etc?

+

It's probably not? But it's nice to have choice.

+

I think it's got two key advantages over those sites:

+
  1. It provides a public, well-documented API with an OpenAPI specification. Other sites don't have official APIs or don't bother documenting them publicly, because they want people to use their web page. I like Spothole's web page, but you don't have to use it—if you're a programmer, you can build your own software on Spothole's API. Spothole does the hard work of taking all the various data sources and providing a consistent, well-documented data set. You can then do the fun bit of writing your own application.
    2. +
  2. It grabs data from a lot more sources already, and it's easy to add more. Since it's open source, anyone can contribute a new data source and share it with the community.
+

Why does a website ask me if I want to install it?

+

Spothole is a Progressive Web App, which means you can install it on an Android or iOS device by opening the site in Chrome or Safari respectively, and clicking "Install" on the pop-up panel. It'll only prompt you once, so if you dismiss the prompt and change your mind, you'll find an Install / Add to Home Screen option on your browser's menu.

+

Installing Spothole on your phone is completely optional, the website works exactly the same way as the "app" does.

+

What licence does Spothole use?

+

Spothole is licenced under the Public Domain. You can write a Spothole client, run your own server, modify it however you like, you can claim you wrote it and charge people £1000 for a copy, I don't really mind. (Please don't do the last one. But if you're using my code for something cool, it would be nice to hear from you!)

+

Privacy

+

Spothole collects no data about you, and there is no way to enter personally identifying information into the site apart from by spotting and alerting through Spothole or the various services it connects to. All spots and alerts are "timed out" and deleted from the system after a set interval, which by default is one hour for spots and one week for alerts.

+

Settings you select from Spothole's menus are sent to the server, in order to provide the data with the requested filters. They are also stored in your browser's local storage, so that your preferences are remembered between sessions.

+

There are no trackers, no ads, and no cookies.

+

Spothole is open source, so you can audit the code if you like.

\ No newline at end of file diff --git a/views/webpage_alerts.tpl b/views/webpage_alerts.tpl index a00380f..92901c4 100644 --- a/views/webpage_alerts.tpl +++ b/views/webpage_alerts.tpl @@ -33,10 +33,11 @@

Alerts to view:

diff --git a/views/webpage_base.tpl b/views/webpage_base.tpl index e1045db..a3503a6 100644 --- a/views/webpage_base.tpl +++ b/views/webpage_base.tpl @@ -61,7 +61,6 @@
  • Alerts
  • About
  • API
    • -
  • Source Code
    • @@ -72,6 +71,21 @@ {{!base}} + + diff --git a/webassets/css/style.css b/webassets/css/style.css index 77e95af..f3ca47d 100644 --- a/webassets/css/style.css +++ b/webassets/css/style.css @@ -1,7 +1,27 @@ +/* NAVIGATION */ + .navbar-nav .nav-link.active { font-weight: bold; } + +/* GENERAL PAGE LAYOUT */ + +div.container { + display:grid; + grid-template-rows:auto 1fr auto; + grid-template-columns:100%; + + /* fallback height */ + min-height:100vh; + + /* new small viewport height for modern browsers */ + min-height:100svh; +} + + +/* ABOUT PAGE*/ + #info-container{ width: 100%; } @@ -13,6 +33,21 @@ } } + +/* SPOTS/ALERTS PAGES, SETTINGS/STATUS AREAS */ + +div.appearing-panel { + display: none; +} + +p.filter-card-text { + line-height: 2.5em !important; +} + + + +/* SPOTS/ALERTS PAGES, MAIN TABLE */ + /* Custom version of Bootstrap table colouring to colour 2 in every 4 rows, because of our second row per spot that appears on mobile */ .table-striped-custom > tbody > tr:nth-of-type(4n+3) > *, @@ -66,14 +101,6 @@ span.mode-q { color: lightgray; } -div.appearing-panel { - display: none; -} - -p.filter-card-text { - line-height: 2.5em !important; -} - a.dx-link { color: var(--bs-emphasis-color); text-decoration: none; @@ -89,6 +116,9 @@ tr.table-faded td span { text-decoration: line-through !important; } + +/* GENERAL MOBILE SUPPORT */ + @media (max-width: 991.99px) { .hideonmobile { display: none !important;