Back to Blog
Product Updates

Uptinio GNOME Extension: Monitor Uptime & Alerts Right in Your GNOME Shell

February 9, 2026
5 min read
By Uptinio Team
Uptinio GNOME Extension: Monitor Uptime & Alerts Right in Your GNOME Shell - Featured image

We're excited to announce the release of the Uptinio Monitor GNOME Extension—a new way to keep an eye on your monitors without leaving your desktop. If you use GNOME Shell (GNOME 45, 46, or 47), you can now see real-time uptime status and open your Uptinio dashboard with a single click.

Why a GNOME Extension?

Many of our users run Linux and GNOME as their daily environment. We wanted to bring Uptinio closer to where you work: your panel. No need to keep a browser tab open or switch contexts—your monitor status is always visible, and alerts are right there when you need them.

What You Get

Real-time status in the panel

Monitor health at a glance with a color-coded indicator (green = up, red = down, gray = paused)

Auto-refresh

Status updates automatically every 60 seconds (configurable from 10 to 3600 seconds in preferences)

Monitor list in a dropdown

Click the panel icon to see all monitors with status icons and open any monitor in your browser

Summary statistics

See up/down/paused counts at a glance

Secure token storage

Your API token is stored securely using GSettings—no plain-text config files

Preferences in GNOME Settings

Configure API token and refresh interval from Extensions → Uptinio Monitor

How to Install

Quick install (recommended)

Clone or download the Uptinio GNOME Extension repo, then run:

shell
git clone https://github.com/Solar-Devs/uptinio-gnome-extension.git
cd uptinio-gnome-extension
./install.sh

Restart GNOME Shell (Alt+F2, type `r`, Enter). On Wayland you may need to log out and back in.

Install from package

You can also build a zip and install it via GNOME Extensions:

shell
./package.sh
# Then: gnome-extensions install build/uptinio-gnome-extension@uptinio.com-v1.0.0.zip

Get Your API Token

To use the extension you need a Uptinio API token:

  • Log in to your Uptinio Dashboard
  • Go to Settings → API
  • Generate or copy your API token
  • Then open the extension menu from the panel, paste the token, and click Save. Monitors will load and start refreshing automatically.

    Status Indicators

    Panel colorMeaning
    UpGreenMonitor is healthy and responding
    DownRedMonitor is down or not responding
    PausedGrayMonitor is paused

    Requirements

  • GNOME Shell 45, 46, or 47
  • libsoup 3.0
  • GSettings (included with GNOME)
  • Try It and Give Feedback

    The extension is open source (MIT) and available on GitHub: Solar-Devs/uptinio-gnome-extension. We'd love to hear what you think—open an issue or pull request if you have ideas or run into any problems.

    Related

  • Website monitor: the HTTP(S) checks that feed your panel status
  • Cron job monitor: heartbeat checks for scheduled jobs
  • Happy monitoring from your panel—and thank you for using Uptinio.

    Share this article

    Ready to improve your uptime monitoring?

    Start monitoring your services for free today. No credit card required.