Skip to content

About

Windows and Linux desktop app for browsing OpenRouter models, tracking credits, and copying exact model IDs.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

OpenRouter Monitor

OpenRouter Monitor application preview

A desktop app for Windows and Linux for browsing OpenRouter models across output categories, comparing prices, tracking credits, and copying the exact model identifier with one click.

Download

Download OpenRouter Monitor v1.2.0 for Windows or Linux. Python is not required for the executables. Your existing settings and favorites are reused automatically.

Windows

Extract the portable ZIP and run OpenRouter Monitor.exe, or run the standalone .exe directly.

Linux (x86_64)

  • Debian, Ubuntu and derivatives: install the .deb package, then launch OpenRouter Monitor from the applications menu.

    sudo apt install ./openrouter-monitor_1.2.0_amd64.deb
  • Any distribution: extract the portable archive and run ./install.sh to add the app to your menu for the current user (no root needed), or run ./openrouter-monitor directly. ./install.sh --uninstall removes it.

    tar xzf OpenRouter-Monitor-v1.2.0-linux-x86_64.tar.gz
    cd OpenRouter-Monitor-v1.2.0-linux-x86_64
    ./install.sh

The Linux build needs glibc 2.39 or newer (Debian 13, Ubuntu 24.04, Fedora 40 or later). It is tested on Debian 13 with KDE Plasma.

Features

  • Dark and amber UI based on the supplied design, with the application and tray icon on Windows and Linux
  • Fast model listing with search, a clear button, sorting, and favorites
  • Category selector: Text, Image, Video, Speech, Decisions, Embeddings, Rerank, Transcription, and Audio
  • Official OpenRouter popularity ranking and sortable model addition dates
  • Promotional offers marked with an asterisk, their discount percentage, a dedicated filter, and sorting
  • Color-coded Tokens, Input / 1M, and Output / 1M
  • One-click copy of the exact OpenRouter model id
  • Credit usage and remaining credit display
  • Local cache for fast startup
  • System tray integration with credit summary tooltip
  • Simple settings dialog for start at login, tray behavior, and credit refresh timer

Requirements

  • Windows 10 or Windows 11, or a 64-bit Linux desktop
  • Python 3.10+ to run from source
  • An OpenRouter API key for live account credit data (model browsing works without a key)

Setup

Install dependencies:

pip install -r requirements.txt

On Linux, install Tk and, for the tray menu, PyGObject with AppIndicator from your distribution first. On Debian or Ubuntu:

sudo apt install python3-tk python3-venv python3-gi gir1.2-ayatanaappindicator3-0.1
python3 -m venv --system-site-packages .venv
.venv/bin/pip install -r requirements.txt

Create your local environment file (cp instead of copy on Linux):

copy .env.example .env

Set your OpenRouter API key in Settings, or supply an initial default in .env:

OPENROUTER_API_KEY=sk-or-v1-xxxxxxxx

A key saved in Settings takes precedence over the .env default. Your existing settings, favorites, and model cache remain in the same user data directory.

Run From Source

python run.py

Build the Executables

build.py builds for the platform it runs on.

pip install pyinstaller
python build.py

Windows output:

dist/OpenRouter Monitor.exe

Linux output (run it from the virtual environment above; dpkg-deb builds the package):

dist/openrouter-monitor
dist/OpenRouter-Monitor-v1.2.0-linux-x86_64.tar.gz
dist/openrouter-monitor_1.2.0_amd64.deb

The Linux executable needs the glibc version of the machine that built it, or newer, so build on the oldest distribution you want to support.

Main Files

  • openrouter_monitor_gui.py - main application
  • run.py - local launcher
  • build.py - PyInstaller build script for Windows and Linux
  • OpenRouter Monitor.spec - PyInstaller spec file (Windows)
  • installer.iss - Inno Setup installer script (Windows)
  • packaging/linux/ - Linux desktop entry and per-user install script

How To Use

  • Click the star to add or remove a favorite
  • Click a column header to sort
  • Type in the search bar to filter models
  • Search names, provider IDs, descriptions, and output categories
  • Click the cross or press Escape in the search field to clear it; / or Ctrl+F focuses search
  • Choose a category from the dropdown below the action buttons
  • Click Popularity to sort by OpenRouter's official most-popular order (lowest rank first)
  • Click Added to show the newest additions first; click again to reverse
  • Click Offers to show promotional models, and Offer * to sort by the largest discount first
  • Click a model row to copy the exact OpenRouter model id
  • Click the right-hand chevron to open the model's full pricing and provider details
  • Use Refresh credits and Refresh list to update data manually
  • Press F5 to refresh the catalog, ranking, and promotions
  • Edit your API key in Settings

Local App Data

User data is stored in:

%USERPROFILE%\.openrouter_monitor\     (Windows)
~/.openrouter_monitor/                 (Linux)

On Linux, Start at login creates ~/.config/autostart/openrouter-monitor.desktop.

Important files:

  • config.json
  • favorites.json
  • models_cache.json
  • app.log

Notes

  • The public model catalog refreshes without an API key; account credits require a valid key
  • Categories use output modalities: a model that understands video and generates text belongs to Text; a model that generates video belongs to Video
  • Popularity is the ordering from OpenRouter's most-popular catalog, not a quality score or a count of local favorites
  • Addition dates are OpenRouter's created timestamps displayed in UTC
  • Promotions come from OpenRouter's discounted model collection. The collection may list only a subset of active offers. Badges are rechecked on catalog refresh and expire after 24 hours in a cached catalog
  • Prices shown for offers already reflect the current catalog price; the discount is informational and is not applied a second time
  • Speech input may be billed per million characters. Video, transcription, and reranking use other billing units: the table shows See rates and the chevron opens their full pricing
  • Live credit information depends on the OpenRouter endpoints available for your key
  • On Linux the tray icon uses StatusNotifier (AppIndicator). KDE Plasma supports it out of the box; GNOME needs the AppIndicator extension. Without a tray, minimizing keeps the window in the taskbar instead of hiding it

Validation

python -m unittest discover -s tests -v
python -m py_compile openrouter_monitor_gui.py model_catalog.py monitor_theme.py build.py

GitHub Actions runs the catalog tests and Python compilation checks on Windows and Linux for pushes, pull requests, and version tags. GUI and executable smoke checks are performed locally on Windows and on Debian 13.

About

Windows and Linux desktop app for browsing OpenRouter models, tracking credits, and copying exact model IDs.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages