Skip to content

Dexjack/ollama-widget

Repository files navigation

Ollama & OpenRouter Usage Monitor

A lightweight, no-tracking Android home-screen widget that shows your current usage for Ollama Cloud and OpenRouter.ai at a glance.

Features

  • Ollama Cloud tracking — weekly usage, plan badge, session usage
  • OpenRouter Management Key — auto-discovers all account keys via /api/v1/keys
  • Three widget layouts — combined, Ollama-only, OpenRouter-only
  • Three progress styles — line, arc, circle
  • Five theme presets — Midnight, Grok, White, Sunset, Forest
  • Doze-resistant auto-update via AlarmManager exact wake
  • Russian / English UI — follows system language

Install

Download the latest app-release.apk from the Releases page and sideload it:

adb install -r app-release.apk

Requirements: Android 8.0 (API 26) or newer.

Setup

  1. Open the app and walk through onboarding
  2. For Ollama: sign in to ollama.com in the in-app WebView
  3. For OpenRouter: create a Management Key at https://openrouter.ai/settings/keys and paste it
  4. Add a widget from your home screen

Build from source

git clone https://github.com/Dexjack/ollama-widget.git
cd ollama-widget
./gradlew assembleDebug

Architecture

app/src/main/java/com/ollamawidget/
├── App.kt                          # Application class
├── data/                           # SharedPreferences, log buffer
├── network/                        # Ollama WebView, OpenRouter API
├── ui/                             # Activities + Compose screens + theme
└── widget/                         # AppWidgetProvider + helpers

Privacy

This app calls only Ollama Cloud and OpenRouter using credentials you provide. No analytics, no third-party SDKs, no telemetry, no crash reporting.

Full details: see PRIVACY.md.

License

MIT — see LICENSE.

About

Android home-screen widget for monitoring Ollama Cloud & OpenRouter.ai usage

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages