UniFi Stock Watcher

A desktop stock monitoring tool for the Ubiquiti Store. Tracks product availability across the entire UniFi catalog and alerts you the moment something comes back in stock — with Windows notifications, sound alerts, and automatic browser launch.

Built with Python and tkinter. No API key required — works by polling the public store API.

Features

• Full-store stock change monitoring — Every poll cycle fetches the entire UniFi catalog (~460+ products) and diffs against the previous snapshot, showing every stock transition across the store in a live feed
• Watch list with favourites — Pick specific out-of-stock items to monitor, star the ones you care about most
• Windows notifications + sound alerts — System tray balloon notifications with optional sound when a watched item comes back in stock
• Auto browser launch — Automatically opens the store page when something you're watching becomes available
• Price tracking — Displays current prices with proper currency formatting (USD, EUR, GBP, CAD)
• Category filtering — Browse dialog filters by product category (Gateways, Switching, WiFi, Cameras, Door Access, etc.)
• Multi-region support — US, EU, UK, and Canada stores
• Configurable poll interval — 15s to 600s, adjustable from Settings
• Stock history tab — Persistent log of every check with statistics
• Export/Import watch lists — JSON backup and sharing
• Per-item quick check — Check a single product immediately without waiting for the next cycle
• Force check (F5) — Interrupt the countdown and trigger an immediate full poll
• Colour themes — 5 built-in presets (Dark, Midnight Blue, Slate, Light, UniFi Blue) plus full custom colour picker
• Customizable typography — Font family and size settings
• Auto-start option — Begin monitoring immediately on launch
• CLI mode — Headless console watcher for servers or background use

Screenshots

Installation

Prerequisites

• Python 3.8+ (python.org — check "Add to PATH" during install)
• Windows 10/11 (notifications use Windows Forms)

Quick Start

1. Download or clone this repo
2. Double-click install_and_run.bat
3. Choose option 1 to launch the GUI

Manual Setup

pip install requests
python unifi_watcher_gui.py

CLI Mode

python unifi_watcher.py           # Start watching (setup on first run)
python unifi_watcher.py --setup   # Re-pick watched items
python unifi_watcher.py --test    # Verify notifications work

Usage

GUI

1. Click "+ Add Items" to browse the store catalog
2. Filter by category, search by name, or toggle "Show in-stock" to see everything
3. Check the items you want to watch and click "Add to Watch List"
4. Star your highest-priority items (they get a dedicated Favourites section)
5. Click "▶ Start Watching" to begin monitoring

Keyboard Shortcuts

Key	Action
F5	Force immediate check
Ctrl+N	Open browse dialog

Stock Changes Feed

The STOCK CHANGES panel below the watch list shows every stock transition across the entire UniFi store — not just your watched items. Green ▲ arrows for items coming back in stock, red ▼ arrows for sellouts.

The first check cycle establishes a baseline. Every cycle after that diffs the full catalog and logs transitions.

Settings

The Settings tab lets you configure:

• Poll interval — How often to check (15–600 seconds)
• Sound alerts — Toggle system sound on in-stock alerts
• Auto-open URL — Toggle automatic browser launch
• Auto-start — Begin watching immediately on launch
• Store region — US, EU, UK, or Canada
• Colour theme — Presets or custom colours
• Font — Family and size

Project Structure

UnifiStockWatcher/
├── unifi_core.py          # Shared module: store API, config, notifications, history
├── unifi_watcher.py       # CLI watcher (headless console mode)
├── unifi_watcher_gui.py   # GUI application (tkinter)
├── install_and_run.bat    # Windows launcher with dependency install
├── launch_gui.bat         # Quick GUI launcher
├── requirements.txt       # Python dependencies
├── .gitignore
├── LICENSE
└── README.md

Generated Files (not tracked)

These are created at runtime and excluded via .gitignore:

File	Purpose
watched_items.json	Your watch list
settings.json	GUI settings and preferences
stock_history.json	Stock check event log

How It Works

The tool uses Ubiquiti's public Next.js store API:

1. Fetches the buildId from the store homepage (cached for 5 minutes)
2. Pulls product data from 9 category endpoints via /_next/data/{buildId}/...
3. Parses variant status fields (Available, SoldOut, ComingSoon)
4. Diffs the full catalog against the previous snapshot to detect transitions
5. Checks watched items against the catalog and fires notifications on availability

No authentication, scraping, or rate-limit-busting — just standard JSON endpoints with polite polling intervals.

Configuration Files

All config files are JSON and stored alongside the script:

watched_items.json

[
  {
    "title": "Switch Pro 24",
    "slug": "usw-pro-24",
    "favourite": true,
    "price": "$379.00",
    "added_at": "2025-03-17T15:01:00"
  }
]

settings.json

{
  "poll_interval": 60,
  "sound_alerts": true,
  "auto_open_url": true,
  "auto_start": false,
  "region": "us",
  "font_size": 10,
  "font_family": "Segoe UI",
  "bg": "#0d1117",
  "accent": "#1f6feb"
}

Notes

• The store's buildId rotates periodically. The tool auto-detects this and refreshes with exponential backoff retry.
• Poll interval should be kept at 60s+ to be respectful to Ubiquiti's servers. The default is 60s.
• Notifications use PowerShell's System.Windows.Forms.NotifyIcon — works on all Windows 10/11 systems without extra dependencies.
• The full catalog fetch (~9 HTTP requests per cycle) is actually more efficient than individual product checks when watching many items.

License

MIT License — see LICENSE for details.