RemindMe

A minimalist, natural language-powered reminder app for macOS

---

✨ Why RemindMe?

• Ultra-lightweight — Built with SwiftUI for modern macOS performance, minimal RAM/CPU usage.
• Natural Language Parsing — Set reminders with ease using tokens like @1m, @10m, @1h.
• Dual Input Modes — Type your time to get smart suggestions, or select custom durations directly from an elegant visual TimePicker UI.
• Stay Awake — Keep your Mac awake from the Status Board using native macOS power assertions (with options to keep screen awake, or stay awake when laptop lid closes).
• Periodic Breaks — Build healthy work habits with automated periodic focus/eye breaks showing a custom Sinclair/Cos-animated countdown overlay.
• Low Battery Alert — Get notified when the MacBook battery drops below a customizable threshold (10%, 15%, 20%, 30%) on battery power, automatically updating with each 1% drop and stopping once plugged in.
• Focus Analytics — Track your productivity with aggregate focus time and snooze counts natively in the Status Board.
• Global Hotkey — Use a customizable global shortcut to instantly bring up the command window from anywhere.
• Todoist-inspired Design — Clean, functional interface, beautiful hover-reveal UI for completed tasks, and elegant popovers.
• Auto Launch — Enable launch at login so your reminder system is always ready when you are.
• Privacy First — Everything stays on your Mac, no cloud syncing, no data tracking.
• Native Experience — Deeply integrated with macOS notifications and menu bar tools.

---

📥 Download

  

1. Download the .dmg corresponding to your Mac's processor (Apple Silicon or Intel) from the latest release.
2. Drag RemindMe.app to your Applications folder.
3. Launch it (lives in your menu bar).
4. Note (Notarized): The app is signed and notarized by Apple, so it will open directly without security prompts.

---

🚀 Getting Started

1. Launch RemindMe — it will appear in your menu bar with a clock icon.
2. Press ⌘⇧Space from any app to open the Command Window.
3. Type your reminder (e.g., Call Mom @10m or Check the oven @5m).
4. Press Enter to set the reminder.
5. Open the Status Board from the menu bar to review reminders, take a break, or start Stay Awake for 5m, 10m, 30m, 1h, 2h, 4h, or indefinitely.
6. Receive a native notification when the timer expires!

---

⌨️ Keyboard Shortcuts

Shortcut	Action
⌘⇧Space	Open command window
↵ Enter	Save reminder
⎋ Esc	Close command window
⌘ ,	Open Settings

---

Screenshots

status board — glance, don't manage low battery alert — custom popup	type anything. smart default: 5 minutes.
	use @10m or @1h for precise timing
	or pick from presets. custom down to the second.
	it fires. mark done, extend, or snooze.
Run with lip closed

🛠️ Building from Source

# Clone the repository
git clone https://github.com/samirpatil2000/remindme.git
cd remindme

# Open in Xcode
open Package.swift

# Build and run
# Press ⌘R in Xcode

Requirements

• macOS 15.0 or later
• Xcode 16.0 or later
• Swift 6.0

---

📁 Project Structure

RemindMe/
├── App/
│   ├── AppDelegate.swift       # App lifecycle, hotkey & battery listener
│   └── RemindMeApp.swift       # Swift entry point
├── Managers/
│   ├── BatteryManager.swift    # IOKit battery level & charger monitoring
│   ├── CaffeinateManager.swift # Stay Awake process lifecycle
│   ├── HotkeyManager.swift     # Global keyboard shortcuts (Carbon API)
│   ├── NotificationManager.swift # macOS notification delivery
│   └── PermissionsManager.swift # Notification permissions handler
├── Parser/
│   ├── ReminderParser.swift    # Natural language parsing logic
│   └── TimeToken.swift         # Duration token definitions (@1m, etc.)
├── Models/
│   └── Task.swift             # Core reminder task models
├── Settings/
│   └── SettingsView.swift      # Settings layout and global hotkey capture
└── Views/
    ├── CommandWindow/         # Quick command window entry UI
    ├── LockOverlay/           # Fullscreen timer lock screens
    ├── MenuBar/               # Status board menu item & popover
    └── Popups/
        ├── PopupManager.swift # Stacking custom alerts controller
        ├── PopupStackView.swift # Custom reminder alert UI card
        └── BatteryPopupView.swift # Custom low battery warning card

---

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests

---

📄 License

MIT License — feel free to use this project however you like.

---

Made with ❤️ for macOS