Widgets

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.

---

Table of Contents

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

---

Recent QSOs Widget

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

URL

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).

Prerequisites

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

Embed Example

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

Columns Shown

Column	Description
Date	Date of the QSO
Time	UTC time
Call	Contacted callsign
Mode	Operating mode (or submode)
Sent	RST sent (plus serial/exchange if contest)
Recv	RST received (plus serial/exchange if contest)
Band	Band, or satellite name if a satellite QSO

---

On Air Status Widget (HTML)

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.

URL

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

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

Prerequisites

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

Embed Example

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

What It Shows

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

Sizing Tips

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.

---

On Air Status Badge (SVG Image)

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.

URL

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

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

Embed Example

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

Badge Appearance

The badge is split into two sections:

Left (dark grey)	Right
Callsign	Status information

Right panel colours:

Colour	Meaning
🟢 Green	On air — radio active within the last 15 minutes
⚫ Grey	QRT — no recent radio activity

Right panel text examples:

Situation	Text shown
HF with frequency and mode	14.225 MHz SSB
Satellite pass	SAT: AO-7
Multiple active radios	14.225 MHz SSB +1 more
No CAT data	qrt

Forum / Markdown Usage

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

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

---

Prerequisites

Public Slug (for the QSOs widget)

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}.

CAT Interface (for the On Air widgets)

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.