Skip to content

guyguy2/SimpleRandomReminders

Repository files navigation

Simple Random Reminders

An Android app that delivers your custom reminder messages at random times throughout the day. Set a time window, choose how many reminders you want, pick which days to receive them - and let the app handle the rest.

Inspired by the iOS app "Yapp Random Reminders". Fully free, no ads, no accounts, no internet required.


Screenshots

Home Editor Quotes Settings
Home Editor Quotes Settings

Features

  • Random scheduling - Notifications fire at random times within a configurable window (e.g. 9am-9pm)
  • Frequency control - 1 to 9 reminders per day per reminder
  • Active days - Choose which days of the week each reminder is active
  • Color coding - Assign colors to reminders for visual organization
  • Action items - Attach yes/no questions to a reminder, answerable directly from the notification
  • Custom notification sounds - Per-reminder sound selection
  • Quotes library - Browse ~100 curated quotes (motivation, mindfulness, health, gratitude) and add them as reminders
  • Home screen widget - Glance widget showing a random active reminder
  • Search and sort - Search by text, sort by date, color, or alphabetically
  • JSON backup - Export and import your reminders
  • PDF export - Export all reminders as a formatted PDF
  • Dark mode - System, light, or dark theme
  • Material You - Dynamic color support on Android 12+

Privacy

All data stays on your device. No accounts, no cloud sync, no tracking, no internet permission.

Requirements

  • Android 12 (API 31) or higher

Tech Stack

  • Kotlin + Jetpack Compose
  • Material 3 / Material You
  • Room (local database)
  • Hilt (dependency injection)
  • DataStore (preferences)
  • AlarmManager (exact alarm scheduling)
  • Glance (home screen widget)
  • Navigation Compose with type-safe routes

Building

# Debug APK
./gradlew assembleDebug

# Release APK
./gradlew assembleRelease

# Unit tests
./gradlew testDebugUnitTest

# Lint
./gradlew lint

Architecture

Single-module MVVM + Repository pattern.

app/src/main/java/com/happypuppy/simplerandomreminders/
├── data/          # Room database, DAOs, DataStore, repository implementations
├── domain/        # Models, scheduler interfaces
├── di/            # Hilt modules
├── ui/            # Compose screens, navigation, theme
├── notification/  # AlarmManager scheduling, boot receiver, notification management
├── widget/        # Glance home screen widget
└── util/          # PDF export, JSON backup

License

MIT

About

Android app that delivers custom reminder notifications at random times within a configurable window

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages