Skip to content

Repository files navigation

MeowRR app icon

MeowRR

Minimal MRR tracker
A small desktop app that connects directly to Stripe

Download the latest MeowRR release

MeowRR showing annual recurring revenue and a yearly revenue chart

Get started · Requirements · Supported data · Security · macOS help · Run from source

Get started

  1. Download the latest release for your computer:
    • macOS: .dmg
    • Windows: .exe
    • Linux: .AppImage or .deb
  2. Open MeowRR and click the settings button in the bottom-right corner.
  3. Paste a restricted Stripe API key with read access to subscriptions, then click Save.

Create a restricted key from the Stripe API keys page. MeowRR only needs read access and never changes your Stripe data.

Revenue refreshes every minute while the app is open and online. Press Tab to see the keyboard shortcuts.

No Stripe key yet? MeowRR starts with clearly labelled demo data so you can try it safely.

Requirements

  • macOS, Windows, or Linux
  • A Stripe account
  • A restricted Stripe key that can read subscriptions

What MeowRR supports

Works today Not supported yet
USD subscriptions Other or multiple currencies
Monthly and annual billing Other billing intervals
Fixed prices Usage-based or tiered prices
Active, paid subscriptions Discounted subscriptions

Trials, unpaid subscriptions, and free subscriptions are excluded from the total.

Privacy and security

Important

Use a restricted, read-only Stripe key. Never use your full Stripe secret key.

  • Your key goes directly from MeowRR to Stripe. It is never sent to JB Bouhier or another server.
  • The key is saved locally so you do not need to enter it every time.
  • The key is not encrypted on disk in this version.
  • If Stripe or your internet connection is unavailable, MeowRR keeps the last successful value on screen and retries automatically.

Opening MeowRR on macOS

Note

MeowRR is free and is not notarized by Apple. macOS may block the first launch.

Download MeowRR only from the official GitHub Releases page, then:

  1. Try to open MeowRR once and dismiss the warning.
  2. Open System Settings → Privacy & Security.
  3. Find the message that MeowRR was blocked and click Open Anyway.
  4. Confirm Open.

You normally need to do this only once.

Run from source

Show build instructions

You do not need the source code to use MeowRR. Download the ready-to-use app above unless you specifically want to build it yourself.

Install:

Then run:

git clone https://github.com/notacatventures/meowrr.git
cd meowrr
bun install
bun tauri dev

The first run may take a few minutes while Rust compiles the app.

Create a production build with:

bun tauri build

Builds are written to src-tauri/target/release/bundle/.

Run the test suite with:

bun run ci

Test-only Stripe responses and revenue histories live in tests/fixtures/ and are not included in the app.

To check the app against a real Stripe account, see Testing against Stripe. It covers seeding a test-mode account with subscriptions, since MeowRR reads /v1/subscriptions only and an empty account is indistinguishable from a broken poll.

Made by JB Bouhier

About

Minimal MRR tracker

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages