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 OpenRouter Monitor v1.2.0 for Windows or Linux. Python is not required for the executables. Your existing settings and favorites are reused automatically.
Extract the portable ZIP and run OpenRouter Monitor.exe, or run the standalone .exe directly.
-
Debian, Ubuntu and derivatives: install the
.debpackage, 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.shto add the app to your menu for the current user (no root needed), or run./openrouter-monitordirectly../install.sh --uninstallremoves 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.
- 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, andOutput / 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
- 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)
Install dependencies:
pip install -r requirements.txtOn 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.txtCreate your local environment file (cp instead of copy on Linux):
copy .env.example .envSet your OpenRouter API key in Settings, or supply an initial default in .env:
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxA key saved in Settings takes precedence over the .env default. Your existing settings, favorites, and model cache remain in the same user data directory.
python run.pybuild.py builds for the platform it runs on.
pip install pyinstaller
python build.pyWindows 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.
openrouter_monitor_gui.py- main applicationrun.py- local launcherbuild.py- PyInstaller build script for Windows and LinuxOpenRouter Monitor.spec- PyInstaller spec file (Windows)installer.iss- Inno Setup installer script (Windows)packaging/linux/- Linux desktop entry and per-user install script
- 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 creditsandRefresh listto update data manually - Press F5 to refresh the catalog, ranking, and promotions
- Edit your API key in Settings
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.jsonfavorites.jsonmodels_cache.jsonapp.log
- 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-popularcatalog, not a quality score or a count of local favorites - Addition dates are OpenRouter's
createdtimestamps 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
python -m unittest discover -s tests -v
python -m py_compile openrouter_monitor_gui.py model_catalog.py monitor_theme.py build.pyGitHub 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.
