glance-myspeed

A Glance widget to display your MySpeed speedtest results.

Overview • Quick Start • Widget Options • References

---

Overview

A drop-in Glance custom-api widget to display your MySpeed speedtest results.

The widget can optionally show a centered Last test footer. The timestamp is formatted based on age:

• today: Last test: 18:42
• yesterday: Last test: yesterday 23:00
• older: Last test: 18.03. 23:00

If showRelativeTime is enabled, the footer appends Glance's relative age output with a trailing ago, for example Last test: 18:42 · 27m ago.

Widget	Purpose	File
Speed	Download/Upload speeds with ping and percentage diff from average	widgets/myspeed.yml

---

Quick Start

1. Copy widgets/myspeed.yml into your Glance widgets/ folder
2. Set MYSPEED_URL in your .env or Glance environment
3. Include the widget in glance.yml

MYSPEED_URL=http://10.10.1.1:5216

pages:
  - name: Home
    columns:
      - size: full
        widgets:
          - $include: widgets/myspeed.yml

Reference config: examples/glance.yml

---

Widget Options

Speed (widgets/myspeed.yml)

Default (showPercentageDiff: true, showUnit: true, showLastTest: false, showRelativeTime: false)

Footer + Relative Time (showPercentageDiff: true, showUnit: true, showLastTest: true, showRelativeTime: true)

Percentage Only (showPercentageDiff: true, showUnit: false, showLastTest: false, showRelativeTime: false)

Clean (showPercentageDiff: false, showUnit: false, showLastTest: false, showRelativeTime: false)

- type: custom-api
  title: Internet Speed
  cache: 1h
  options:
    showPercentageDiff: true
    showUnit: true
    showLastTest: false
    showRelativeTime: false
  template: |
    # Requests and fallback states are handled inside the template
    ...

Option	Type	Default	Description
showPercentageDiff	bool	true	Show percentage difference from average
showUnit	bool	true	Show "Mbit/s" and "ms" unit labels inline with values
showLastTest	bool	false	Show a centered Last test footer with age-aware formatting (18:42, yesterday 23:00, 18.03. 23:00)
showRelativeTime	bool	false	When showLastTest is enabled, append Glance's relative age output with a trailing ago to the Last test footer

---

References

• Dashboard platform: glanceapp/glance
  Widget implementation targets Glance custom-api behavior and config style.

• Speedtest software: gnmyt/MySpeed
  Self-hosted speedtest tracking tool

• Design inspiration: glanceapp/community-widgets
  Original speedtest-tracker widget

---

License

MIT. See LICENSE.