Widgets - magicbug/Cloudlog GitHub Wiki

Cloudlog includes embeddable widgets that let you display live station information on external websites, blogs, or forum signatures — no login required by visitors.

All widgets are accessed under the /widgets/ URL path of your Cloudlog installation.

• Recent QSOs Widget
• On Air Status Widget (HTML)
• On Air Status Badge (SVG Image)
• Prerequisites

Displays the 15 most recent QSOs from a public logbook in a simple table. Intended for embedding in an <iframe>.

https://your-cloudlog-url/widgets/qsos/{public-slug}

Replace {public-slug} with the public slug configured on your logbook (set under Logbooks → Edit → Public Slug).

Your logbook must have a Public Slug configured. See Setting up a Public Slug below.

<iframe
  src="https://your-cloudlog-url/widgets/qsos/m0abc-home"
  width="600"
  height="400"
  frameborder="0"
  scrolling="auto">
</iframe>

Shows whether a station is currently active, along with their frequency, mode, satellite name, and power output. The page auto-refreshes every 30 seconds and is designed to be embedded in an <iframe>.

Data is sourced from Cloudlog's CAT (radio control) interface. A station is considered on air if their radio has reported data within the last 15 minutes.

https://your-cloudlog-url/widgets/on_air/{callsign}

Replace {callsign} with the callsign registered in Cloudlog (case-insensitive).

The callsign must belong to a registered Cloudlog user and that user must have a radio connected and reporting via the CAT interface.

<iframe
  src="https://your-cloudlog-url/widgets/on_air/M0ABC"
  width="300"
  height="120"
  frameborder="0"
  scrolling="no">
</iframe>

When on air:

• Green ON AIR badge next to the callsign
• Each active radio on its own row showing:
  • Frequency in MHz (e.g. 14.225 MHz)
  • Mode (e.g. SSB, FT8, CW)
  • Power in watts (if reported)
  • Radio name (if set)
  • For satellite QSOs: satellite name and mode instead of frequency

When off air:

• Grey QRT badge
• A message indicating no activity in the last 15 minutes

The widget content is minimal, so a height of 120px is usually sufficient for a single radio. Add approximately 30px per additional radio the station runs.

A compact single-line badge image in SVG format — similar in style to a GitHub Actions badge. Suitable for embedding directly in web pages, forum signatures, or anywhere an <img> tag is accepted. No <iframe> needed.

The badge auto-expires in browsers after 60 seconds, so it will stay close to real-time without hammering your server.

https://your-cloudlog-url/widgets/on_air_image/{callsign}

Replace {callsign} with the callsign registered in Cloudlog (case-insensitive).

<img
  src="https://your-cloudlog-url/widgets/on_air_image/M0ABC"
  alt="M0ABC on air status"
  height="20">

The badge is split into two sections:

Right panel colours:

Right panel text examples:

Most forums that allow image tags will work. In Markdown:

![M0ABC on air status](https://your-cloudlog-url/widgets/on_air_image/M0ABC)

1. Go to Logbooks in your Cloudlog menu
2. Click Edit on the logbook you want to make public
3. Under Public Slug, enter a short alphanumeric identifier (e.g. m0abc-home)
4. Click Save

The logbook will then be accessible at https://your-cloudlog-url/visitor/{slug} and the QSOs widget will work at https://your-cloudlog-url/widgets/qsos/{slug}.

The on air widgets require a radio to be sending live data to Cloudlog via the CAT interface. See the CAT Interface wiki page for setup instructions with supported logging software.

If no CAT data has been received in the last 15 minutes, the widget will show QRT.