Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

capllen/Subnook

Productivity

A local-first Android app for tracking subscriptions, recurring bills and renewal reminders.

171
8
Kotlin
MIT
1 day old

Subnook

Subnook is an Android subscription manager for people who want to record memberships and recurring bills in one place. Each entry stores a name, amount, currency, billing cycle (every N days/weeks/months/years), next payment date, payment method, category and notes. Auto-renewing subscriptions roll to the next period after the billing date, while manual-payment entries wait for an explicit “I paid” confirmation. Data stays on the device.

The app covers reminders, statistics and history. Reminders start three days before the bill date by default (adjustable from 0 to 30 days); overdue manual payments trigger a daily reminder with a direct “paid” action in the notification. The home screen shows weekly, monthly and yearly average spending, and the detailed stats page includes a category donut chart, spending ranking, the next 12 months of due payments, and breakdowns by payment method and currency. A bill calendar shows each day’s due subscriptions and past payments, and a home-screen widget surfaces monthly spending and upcoming charges.

More than 220 preset services (domestic and international software, games, cloud services, VPNs, carriers) come with icons and reference prices. A built-in icon designer or a gallery image can replace the preset icon. For multi-currency use, 30 common currencies are supported with a selectable display currency and exchange rates refreshed every 24 hours from open.er-api.com.

Quick start

  1. Install the APK from Releases. The app requires Android 8.0 or later.
  2. Add a subscription: choose a preset or enter a name, amount, currency and billing cycle, then set the next payment date and payment method.
  3. If the subscription renews automatically, leave it in auto mode; otherwise confirm payment via “I paid” in the app or from the reminder notification.
  4. Open the stats page or calendar to review spending and upcoming charges.

To build from source, use Android Studio with the Subnook/ directory, or run from that directory:

./gradlew assembleDebug
./gradlew testDebugUnitTest

The debug APK is written to app/build/outputs/apk/debug/. The project uses Kotlin, Jetpack Compose (Material 3), Room, DataStore, WorkManager and Glance, and needs JDK 17+ and Android SDK with compileSdk 36. Release builds optionally read signing details from keystore.properties, copied from keystore.properties.example; without it, release builds use the debug signature.

Constraints

  • Android 8.0 or later; exchange-rate updates require network access.
  • Data is stored locally, so backups rely on the JSON export/import (including payment records, custom icons and settings).
  • Reminders can be affected by aggressive background management on some Chinese Android skins. The README suggests enabling “准时提醒”, ignoring battery optimization and allowing auto-start, and notes that ColorOS requires adding the widget from the launcher rather than inside the app.
  • Preset app icons and names belong to their respective owners; the project states it is not affiliated with those companies.
  • Licensed under MIT.

HotRepo's take

Subnook entered HotRepo’s new-project list on 2026-11-18 with 105 stars and 5 forks in its first recorded window, without a GitHub all-language daily rank. That limited record supports the fact that it drew initial attention, not a trend judgment. The project’s strongest practical distinction is local-only storage combined with automatic billing-date rollover and a reminder flow that distinguishes auto-renew from manual payment—details that matter for subscription tracking more than a long feature list.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. holdcloud/mcd-calendar-buddyPulls McDonald's China campaign dates through an MCP tool and writes them into your calendar with reminders.Python152
  2. kargulstudio/calender-app-designA front-end-only calendar and time-off workspace prototype for people-ops UI work, with all data kept in localStorage.TypeScript113
  3. ulsklyc/yuvomiA self-hosted planner that keeps a household's tasks, calendar, meals, shopping and budget in one PWA on your own server.JavaScript1,965
  4. croffasia/itsaplanA self-hosted issue tracker where human teammates and AI agents share the same boards, cycles and assignments.TypeScript1,985