Skip to content

kshk123/create_reminders

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📝 Create Reminders

A Chrome/Firefox extension to capture reminders from any webpage and sync them to Google Calendar or Apple Reminders.

Chrome Web Store Firefox Add-ons

License: MIT macOS Google Calendar

Demo: right-click capture → reminder

✨ Features

  • 🔍 Capture from any webpage - Right-click selected text to save as a reminder
  • 📅 Set due dates/times - Add datetime to any reminder with built-in picker
  • 📆 Google Calendar sync - Send reminders directly to your Google Calendar
  • 🍎 Apple Reminders integration - macOS users can sync to native Reminders app
  • 💾 Local storage - All data stays private in your browser

📖 Documentation

For detailed setup instructions, see SETUP.md

The setup guide includes:

  • Step-by-step Google OAuth configuration
  • Apple Reminders bridge setup for macOS
  • Troubleshooting common issues
  • Feature overview and usage tips

🚀 Quick Start

Browser targets

  • Chrome: use manifest.chrome.json + background.chrome.js (default files are equivalent).
  • Firefox: use manifest.firefox.json + background.firefox.js (promise-based APIs and launchWebAuthFlow).
    • Copy/rename the appropriate manifest/background before loading the extension, or create a packed zip with those files renamed to manifest.json and background.js.

Installation

  1. Clone or download this repository

    git clone https://github.com/kshk123/create_reminders.git
    cd create_reminders
  2. Load the extension in Chrome

    • Open Chrome and navigate to chrome://extensions/
    • Enable Developer mode (toggle in top-right)
    • Click Load unpacked
    • Select the extension folder
    • Pin the extension for quick access (optional)
  3. Start using basic features immediately!

    • No configuration needed for local reminder management
    • Optional: Set up Google Calendar or Apple Reminders (see SETUP.md)

Basic Usage (No Setup Required)

  • Capture from webpage: Highlight text → right-click → "Add to Reminders"
  • Manual entry: Click extension icon → type reminder → click "Save"
  • Set due dates: Use the date/time picker for each reminder
  • Manage reminders: View, edit, or delete from the popup

Optional Integrations

Google Calendar

Requires one-time OAuth setup. See Google Calendar Setup for detailed instructions.

Apple Reminders (macOS only)

Download apple-reminders-bridge.zip from GitHub Releases, extract, and:

  • Auto-start (Recommended): ./install-launchagent.sh install
  • Manual start: ./start-bridge.sh

The bridge runs on http://localhost:19092. The extension fetches the auth token from the running bridge (no token file ships with the extension). See Apple Reminders Setup and Auto-Start Guide for details.

📋 Usage

  • Capture from any page: Highlight text → right-click → "Add to Reminders"
    • Automatically saves the text, page title, URL, and timestamp
  • Manage in popup:
    • Set date/time for any reminder
    • Send to Google Calendar (creates a 1-hour event)
    • Send to Apple Reminders (via local bridge)
    • Delete individual reminders or clear all

🧪 Testing

Run the test suite to validate date parsing and reminder timing:

# Open test runner in browser
open tests/test-runner.html

Click "Run All Tests" to execute the test suite. All tests should pass.

⚙️ Features Breakdown

✅ Works Without Setup

  • Capture reminders from selected text on any webpage
  • Add reminders manually with date/time
  • View and manage all reminders in popup
  • Local storage (private, browser-based)
  • Toast notifications for better UX
  • Bridge connectivity status indicator

🔑 Requires Google OAuth Setup

  • Send reminders to Google Calendar (creates 1-hour events)

🍎 Requires Local Bridge (macOS only)

  • Send reminders to Apple Reminders app
  • Visual indicator shows bridge connection status

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Browser extension to add quick reminders

Resources

License

Stars

Watchers

Forks

Packages

No packages published