Documentation

Version: 1.0 | Last Updated: October 2025

Welcome to Alarm Reminder! This comprehensive guide will help you master all features of the extension and get the most out of your reminder system.

1. Installation & Setup

1.1 Installing the Extension

  1. 1 Open Google Chrome browser
  2. 2 Visit the Chrome Web Store
  3. 3 Search for “Alarm Reminder”
  4. 4 Click “Add to Chrome”
  5. 5 Confirm by clicking “Add extension”
✓ Tip: Pin the extension to your toolbar for quick access. Click the puzzle icon 🧩 in Chrome’s toolbar, then click the pin icon next to Alarm Reminder.

1.2 First Launch

After installation, click the extension icon in your toolbar to open the popup. You’ll see:

  • No active alarms message (initially)
  • “+ Add Alarm” button to create your first reminder
  • “⚙️ Settings” button to customize preferences

1.3 Granting Permissions

The extension requires the following permissions:

Permission Purpose Required
alarms Schedule timed reminders Yes
notifications Display alert notifications Yes
storage Save alarm data locally Yes
identity Google Calendar authentication Optional

2. Quick Start Guide

2.1 Create Your First Alarm (Simple)

  1. Click the extension icon
  2. Click “+ Add Alarm”
  3. Enter a message (e.g., “Coffee break”)
  4. Set time: Select “In minutes” and enter “15”
  5. Click “Save Alarm”
🎉 Success! You’ll receive a notification in 15 minutes with your reminder message.

2.2 Create a Specific Time Alarm

  1. Click “+ Add Alarm”
  2. Enter alarm name (optional) and message
  3. Change “Set Time” to “Specific time”
  4. Select date and time (12-hour format)
  5. Click “Save Alarm”

3. Creating Alarms

3.1 Alarm Components

Alarm Name (Optional)

A short title for your alarm (e.g., “Team Meeting”, “Workout Time”).

  • If left blank, defaults to “Unnamed Alarm”
  • Appears in the notification title
  • Helps identify alarms at a glance

Message (Required)

The main reminder text that appears in the notification.

  • Can include detailed information
  • Supports emoji 😊⏰📅
  • No character limit

3.2 Time Setting Options

Option 1: In Minutes

Set an alarm to trigger after a specific number of minutes from now.

  • Range: 1 to 1440 minutes (24 hours)
  • Best for: Quick reminders, timers, short breaks
  • Examples: 5 minutes, 30 minutes, 2 hours (120 minutes)

✓ Quick Reference:

  • 15 minutes = Quarter hour break
  • 30 minutes = Half hour reminder
  • 60 minutes = 1 hour
  • 120 minutes = 2 hours

Option 2: Specific Time

Schedule an alarm for an exact date and time.

  • Format: 12-hour format (1-12 with AM/PM)
  • Date picker: Select any future date
  • Best for: Appointments, deadlines, scheduled events

3.3 Repeat Types

Repeat Type Description Use Cases
None One-time alarm Appointments, single events
Daily Repeats every day at set time Medication, morning routine
Weekly Repeats on selected days Gym days, team meetings
Monthly Repeats on specific date Bill payments, reports
Custom Custom minute intervals Break reminders, stretching

3.4 Custom Alarm Sounds

Each alarm can have its own sound:

  1. In the alarm form, find “Alarm Sound” dropdown
  2. Select from available sounds:
    • Classic Bell – Traditional alarm sound
    • Mega Horn – Loud and attention-grabbing
    • Chime – Gentle and pleasant
    • Digital Beep – Modern electronic sound
    • Rooster – Morning wake-up call
    • Vintage – Retro alarm clock
    • Warning – Urgent alert sound
    • Casino – Fun winning sound
  3. Click “▶ Preview” to test the sound
  4. Leave blank to use default sound from settings

4. Recurring Alarms

4.1 Daily Alarms

Perfect for habits and daily routines.

How to Create:

  1. Select “Daily” from Repeat Type
  2. Set the time (switches to “Specific time” automatically)
  3. Optionally set an end date
  4. Click “Save Alarm”

Example: Daily medication reminder at 9:00 AM

  • Name: Morning Medication
  • Message: Take your daily vitamins
  • Time: 9:00 AM
  • Repeat: Daily

4.2 Weekly Alarms

Ideal for activities that occur on specific days of the week.

How to Create:

  1. Select “Weekly” from Repeat Type
  2. Check boxes for days: Sun, Mon, Tue, Wed, Thu, Fri, Sat
  3. Set the time
  4. Optionally set an end date
  5. Click “Save Alarm”
✓ Pro Tip: You can select multiple days! For example, check Mon/Wed/Fri for a workout reminder that only triggers on those days.

Example: Gym reminder for Mon/Wed/Fri

  • Name: Gym Time
  • Message: Time for your workout! 💪
  • Time: 6:00 PM
  • Repeat: Weekly (Mon, Wed, Fri selected)

4.3 Monthly Alarms

For events that happen once a month.

How to Create:

  1. Select “Monthly” from Repeat Type
  2. Choose day of month (1-31 or “Last day”)
  3. Set the time
  4. Optionally set an end date
  5. Click “Save Alarm”
⚠ Note: If you select day 31 and a month has only 30 days (or 29/28 for February), the alarm will trigger on the last day of that month.

Example: Monthly rent reminder

  • Name: Rent Payment
  • Message: Pay monthly rent today
  • Time: 10:00 AM
  • Repeat: Monthly (1st of month)

4.4 Custom Interval Alarms

For repetitive reminders at custom intervals.

How to Create:

  1. Select “Custom” from Repeat Type
  2. Enter interval in minutes (e.g., 30, 60, 120)
  3. Set initial time (can use “In minutes” or “Specific time”)
  4. Click “Save Alarm”

Example: Stretch break every 30 minutes

  • Name: Stretch Break
  • Message: Stand up and stretch! 🧘
  • Interval: 30 minutes
  • Repeat: Custom

4.5 Setting End Dates for Recurring Alarms

Limit how long a recurring alarm stays active.

  1. When creating a recurring alarm (daily/weekly/monthly)
  2. Look for “End Date (Optional)” field
  3. Select a date when the alarm should stop
  4. The alarm will automatically stop repeating after that date

✓ Use Cases:

  • Temporary medication course: Set end date for last day
  • Project deadline reminders: Stop after project ends
  • Seasonal activities: Set to end when season changes

5. Google Calendar Integration

5.1 Connecting Google Calendar

⚠ Before You Start:

  • You need a Google account (Gmail)
  • Calendar sync is optional
  • You can disconnect anytime

Connection Steps:

  1. Open extension popup
  2. Click “⚙️ Settings”
  3. Scroll to “Google Calendar Integration”
  4. Click “Connect Google Calendar”
  5. Sign in with your Google account (popup window)
  6. Review permissions and click “Allow”
  7. Wait for confirmation message

What Gets Synced:

  • ✓ Upcoming calendar events (within your time range setting)
  • ✓ Event titles, dates, times, and locations
  • ✓ Changes to calendar events (updates automatically)
  • ✓ Deleted events (removes corresponding alarms)

5.2 Calendar Sync Settings

Reminder Lead Time

How many minutes before an event should the alarm trigger?

  • Default: 15 minutes
  • Options: 0, 5, 10, 15, 30, 60 minutes
  • Example: Meeting at 2:00 PM with 15-min lead time = Alarm at 1:45 PM

Event Filter

Which calendar events to sync:

  • All Events – Sync everything from your calendar
  • Busy Only – Only events marked as “Busy” (skips free time)

Calendar Alarm Sound

Choose a specific sound for calendar-synced alarms (or use default).

5.3 Syncing Alarms TO Google Calendar

You can also add your local alarms to Google Calendar:

  1. Find the alarm in your alarms list
  2. Click the “📅” (calendar) button
  3. Confirm when prompted
  4. The alarm is now a calendar event!

✓ Benefits:

  • See alarms across all devices with Google Calendar
  • Share alarms with others via calendar sharing
  • Integrate with other calendar apps
⚠ Important: When you sync an alarm to Google Calendar, the local alarm is removed and replaced by the calendar event. This prevents duplicate notifications.

5.4 Managing Calendar Sync

Manual Sync

When calendar is connected, you’ll see a “🔄 Sync” button in the header.

  • Click it to manually refresh calendar events
  • Useful after adding/editing events in Google Calendar

Automatic Sync

  • Syncs automatically when you open the extension
  • Syncs periodically in the background (every hour)
  • No action needed on your part

Disconnecting Calendar

  1. Go to Settings
  2. In Calendar section, click the “✓ Connected” button
  3. Confirm disconnection
  4. All calendar-synced alarms will be removed (your local alarms remain)

6. Managing Alarms

6.1 Viewing Alarms

Alarms are organized into time-based groups:

Section Contains
Today Alarms scheduled for today
Tomorrow Alarms scheduled for tomorrow
This Week Alarms within the next 7 days
Next [Time Range] Alarms within your selected time range
Later Alarms beyond your time range
✓ Tip: Adjust your time range in Settings to control which alarms are visible. Options: 1 week, 2 weeks, 4 weeks, 3 months, 6 months, 1 year.

6.2 Alarm Information Display

Each alarm card shows:

  • 🔔 Alarm Name – Title of the alarm
  • ⏰ Time – When it will trigger
  • 💬 Message – Reminder text
  • 🔁 Repeat Info – Recurring pattern (if applicable)
  • 🔊 Sound – Custom sound (if set)
  • 📅 Calendar Status – Sync status (if applicable)

6.3 Editing Alarms

  1. Find the alarm you want to edit
  2. Click the “✏️” (edit) button
  3. The alarm form opens with current settings
  4. Make your changes
  5. Click “Save Alarm”
⚠ Note: Editing an alarm deletes the old version and creates a new one with updated settings. This resets the schedule for recurring alarms.

6.4 Deleting Alarms

Delete Single Alarm:

  1. Find the alarm
  2. Click the “🗑️” (trash) button
  3. Confirm deletion

Clear All Alarms:

  1. Click the “Clear All” button at the top
  2. Confirm that you want to delete ALL alarms
  3. All alarms are permanently removed
⚠ Warning: Clearing all alarms cannot be undone unless you have a backup (see Import/Export section).

7. Settings & Customization

7.1 Accessing Settings

Click the “⚙️ Settings” button in the extension popup.

7.2 General Settings

Default Alarm Sound

  • Choose the default sound for new alarms
  • Can be overridden per-alarm
  • 8 built-in sounds to choose from

Volume

  • Adjust alarm volume (0-100%)
  • Drag the slider or enter a number
  • Click “Test Sound” to preview

Repeat Count

  • How many times the sound plays when alarm triggers
  • Range: 1-10 times
  • Default: 3 times

Enable System Sound

  • Toggle: On/Off
  • When enabled, uses browser notification sound in addition to custom alarm sound
  • Provides fallback if custom sound fails

Show Alarms Up To

  • Control how far ahead to display alarms
  • Options: 1 week, 2 weeks, 4 weeks, 3 months, 6 months, 1 year
  • Helps reduce clutter for users with many future alarms

Enable Chrome Sync

  • Toggle: On/Off
  • When enabled, syncs settings across your Chrome browsers
  • Requires Chrome Sync to be enabled in your browser
  • Alarm data itself stays local (only settings sync)

7.3 Testing Settings

  1. Adjust your settings (sound, volume, repeat count)
  2. Click “🔊 Test Sound”
  3. Listen to the test alarm
  4. Click “🛑 Stop Test” to stop early (if needed)
  5. Adjust settings as needed
  6. Click “Save Settings” when satisfied

✓ Recommended Settings:

  • Volume: 75-80% (loud enough but not jarring)
  • Repeat Count: 3 times (ensures you hear it)
  • System Sound: Enabled (backup notification)

7.4 Saving Settings

  • Click “Save Settings” at the bottom
  • Settings are applied immediately
  • A confirmation message appears
  • Click “× Close” to return to alarms view

8. Import & Export

8.1 Exporting Alarms

Why Export?

  • Backup your alarms
  • Transfer alarms to another computer
  • Keep a record of recurring patterns
  • Restore after uninstalling extension

How to Export:

  1. Go to Settings
  2. Scroll to “Data Management”
  3. Click “📥 Export Data”
  4. A file downloads automatically (JSON format)
  5. Filename: alarm-reminder-backup-YYYY-MM-DD.json

What Gets Exported:

  • ✓ All alarm configurations
  • ✓ Alarm settings (sounds, volume, etc.)
  • ✓ Calendar sync settings
  • ✓ Timestamps and metadata
✓ Best Practice: Export your alarms regularly (e.g., monthly) to prevent data loss.

8.2 Importing Alarms

When to Import:

  • Restore from backup
  • Transfer alarms from another device
  • Recover after accidental deletion

How to Import:

  1. Go to Settings
  2. Scroll to “Data Management”
  3. Click “📤 Import Data”
  4. Select your backup JSON file
  5. Wait for confirmation

⚠ Important Notes:

  • Import adds alarms (doesn’t replace existing ones)
  • Past alarms are automatically skipped
  • Duplicate alarms may be created if you import the same file twice
  • Settings are imported but don’t override current settings unless specified

8.3 File Format

Exported files are in JSON format:

{
  "version": "1.0",
  "timestamp": "2025-01-15T10:30:00Z",
  "alarms": [...],
  "settings": {...},
  "calendarSettings": {...}
}
✓ Advanced Users: You can manually edit the JSON file with a text editor to batch-modify alarms before importing. Be careful to maintain valid JSON structure.

9. Troubleshooting

9.1 Alarms Not Triggering

Check These First:

  • ✓ Is Chrome browser open? (Extension requires Chrome to be running)
  • ✓ Are browser notifications enabled? Check system settings
  • ✓ Is your computer in sleep/hibernation mode?
  • ✓ Is the alarm time set correctly? Check AM/PM
  • ✓ Did you save the alarm? Look for it in the alarms list

Solutions:

  1. Enable Notifications:
    • Windows: Settings → System → Notifications
    • Mac: System Preferences → Notifications → Chrome
    • Chrome: Settings → Privacy and security → Site settings → Notifications
  2. Keep Chrome Running:
    • Chrome must be open (minimized is fine)
    • Consider setting Chrome to start on boot
  3. Check System Time:
    • Ensure your computer’s date/time is correct
    • Alarms use system time

9.2 Sound Not Playing

Troubleshooting Steps:

  1. Test in Settings using “Test Sound” button
  2. Check volume slider – increase to 80%+
  3. Ensure system volume is not muted
  4. Try different sound from dropdown
  5. Enable “System Sound” as fallback
  6. Check if other extensions are blocking audio

9.3 Google Calendar Not Syncing

Common Issues:

Problem Solution
Connection failed Click “Connect” again, allow all permissions
No events synced Check if you have events in the selected time range
Sync button not working Disconnect and reconnect calendar
“Not authenticated” error Re-authenticate in Settings
Events not updating Click manual sync button (🔄)

Reset Calendar Connection:

  1. Go to Settings
  2. Disconnect Google Calendar
  3. Close extension
  4. Reopen extension
  5. Reconnect Google Calendar

9.4 Extension Not Loading

  1. Reload Extension:
    • Go to chrome://extensions
    • Find Alarm Reminder
    • Click the reload icon 🔄
  2. Check for Updates:
    • In chrome://extensions
    • Enable “Developer mode” (top right)
    • Click “Update” button
  3. Reinstall Extension:
    • Export your data first!
    • Remove extension
    • Reinstall from Chrome Web Store
    • Import your data

9.5 Recurring Alarms Not Rescheduling

⚠ Check:

  • Did you set an end date that has passed?
  • Is the alarm still in your alarms list?
  • Open Chrome Developer Console (F12) and check for errors

Fix:

  1. Delete the problematic recurring alarm
  2. Create a new recurring alarm with the same settings
  3. Test by waiting for the first occurrence

9.6 High Memory Usage

If the extension is using too much memory:

  1. Delete old/expired alarms
  2. Reduce “Show alarms up to” time range in Settings
  3. Disconnect calendar sync if not needed
  4. Export data and reinstall extension

9.7 Getting Help

If problems persist:

  1. Check browser console for errors:
    • Right-click extension icon → “Inspect popup”
    • Look for red error messages in Console tab
  2. Take a screenshot of the error
  3. Contact support (see Section 12)

10. Frequently Asked Questions

Q1: Do I need to keep Chrome open for alarms to work?

A: Yes. Chrome must be running (but can be minimized). The extension cannot trigger alarms if Chrome is completely closed.

Q2: Will alarms work if my computer is in sleep mode?

A: No. Alarms only trigger when your computer is active. They will trigger as soon as you wake your computer if the time has passed.

Q3: Can I use this extension on my phone?

A: Only if you’re using Chrome on Android (not iOS). iOS doesn’t support Chrome extensions. For full functionality, use it on desktop Chrome.

Q4: Is my data private?

A: Yes! All alarm data is stored locally on your device. We don’t collect, store, or transmit your personal information. See our Privacy Policy for details.

Q5: Does Google Calendar sync work offline?

A: No. Calendar sync requires an internet connection. However, once synced, calendar alarms will trigger offline (as they’re stored locally).

Q6: Can I sync with calendars other than Google Calendar?

A: Currently, only Google Calendar is supported. Support for other calendar services may be added in future updates.

Q7: How many alarms can I create?

A: There’s no hard limit, but for performance reasons, we recommend keeping it under 100 active alarms.

Q8: Can I share my alarms with others?

A: Not directly, but you can:

  • Export your alarms and send the JSON file
  • Sync alarms to Google Calendar and share the calendar

 

Q9: What happens if I uninstall the extension?

A: All local alarm data is permanently deleted. Export your data first if you want to keep it!

Q10: Can I use custom sound files?

A: Currently, you can only choose from the 8 built-in sounds. Custom sound upload may be added in a future update.

Q11: Why do I see “Unchecked runtime.lastError” in console?

A: This is a harmless warning that doesn’t affect functionality. It will be fixed in the next update.

Q12: Can I set alarms that trigger every X hours?

A: Yes! Use “Custom” repeat type and enter the interval in minutes (e.g., 120 for every 2 hours).

Q13: Is there a mobile app version?

A: Not currently. This is a Chrome extension designed for desktop browsers. A mobile app may be developed in the future.

Q14: Can I snooze alarms?

A: Snooze functionality is not currently available but is planned for a future update.

Q15: Does this work with other Chromium browsers (Edge, Brave, etc.)?

A: It should work on most Chromium-based browsers, but official support is only provided for Google Chrome.

11. Tips & Best Practices

11.1 Organization Tips

✓ Use Descriptive Names

  • Instead of: “Reminder”
  • Use: “Team Standup – Project Alpha”
  • Helps identify alarms quickly in a long list

✓ Use Emoji for Visual Categories

  • 💊 Medication alarms
  • 🏋️ Workout reminders
  • 📞 Call/meeting reminders
  • 💰 Payment/financial reminders
  • 📚 Study/learning sessions

✓ Use Different Sounds for Different Categories

  • Urgent alarms: Mega Horn or Warning
  • Gentle reminders: Chime or Classic Bell
  • Work tasks: Digital Beep
  • Morning alarms: Rooster

11.2 Reliability Tips

⚠ Don’t Rely Solely on Extension for Critical Events

  • Use multiple reminder systems for important appointments
  • Set phone alarms as backup
  • Add events to Google Calendar (which has its own reminders)
  • Computer/browser issues can prevent alarms from triggering

✓ Test Your Setup

  • Create a test alarm for 2 minutes from now
  • Verify notifications work correctly
  • Check sound volume is appropriate
  • Do this after any system changes

11.3 Productivity Tips

Pomodoro TechniqueUse custom interval alarms for focused work sessions:

  1. Create custom alarm: 25 minutes (work)
  2. Message: “Break time! Stand up and stretch”
  3. After break, start another 25-min alarm

Health & Wellness

  • Water intake: Hourly reminder to drink water
  • Eye breaks: 20-minute intervals (20-20-20 rule)
  • Posture checks: Every 30 minutes
  • Medication: Daily reminders at specific times

Time Management

  • Set alarms 5 minutes before meetings to prepare
  • End-of-day reminder to review accomplishments
  • Start-of-day reminder to plan priorities
  • Weekly review reminder (e.g., Friday 4 PM)

11.4 Maintenance Tips

✓ Regular Cleanup

  • Review alarms monthly
  • Delete completed one-time alarms
  • Update recurring alarms if your schedule changes
  • Adjust time range setting to hide far-future alarms

✓ Regular Backups

  • Export data monthly
  • Store exports in cloud storage (Google Drive, Dropbox)
  • Keep at least 2-3 recent backups
  • Test import occasionally to ensure backups work

11.5 Calendar Integration Tips

✓ Hybrid Approach

  • Use Google Calendar for meetings and appointments
  • Use local alarms for personal habits and routines
  • Sync important local alarms to calendar for backup
  • Set lead time based on preparation needed (15-30 min)

11.6 Common Patterns

Use Case Recommended Setup
Morning Routine Daily alarms at staggered times:
• 7:00 AM – Wake up
• 7:30 AM – Leave for work
Medication Daily alarms with clear names:
• 9:00 AM – Vitamin D
• 9:00 PM – Prescription
Work Breaks Custom interval during work hours:
• Every 60 minutes
• “Stand up and stretch!”
Bill Payments Monthly on specific dates:
• 1st of month – Rent
• 15th – Credit card
Gym Schedule Weekly on specific days:
• Mon/Wed/Fri at 6:00 PM
• “Gym time! 💪”

12. Support & Contact

12.1 Getting Help

If you need assistance:

📧 Support

Send me a message here.

Response time: Within 2-5 business days

💬 Chrome Web Store

Leave feedback or questions on the extension’s listing

🐛 Bug Reports

For technical issues, include:

  • Chrome version (Help → About Google Chrome)
  • Extension version (visible in Settings)
  • Steps to reproduce the issue
  • Screenshots (if applicable)
  • Console errors (press F12)

💡 Feature Requests

We love hearing your ideas! Email us or leave a review with your suggestions.

12.2 Useful Resources

12.3 Keyboard Shortcuts (Debug)

For advanced users:

Shortcut Action
Ctrl + D Show debug information in console
Ctrl + S Test all sound files

12.4 Stay Updated

Extension updates are automatic via Chrome Web Store. To check for updates manually:

  1. Go to chrome://extensions
  2. Enable “Developer mode” (top right)
  3. Click “Update” button

12.5 Share Feedback

Help us improve! Your feedback matters:

  • ⭐ Rate the extension on Chrome Web Store
  • 📝 Write a review (positive or constructive)
  • 💡 Suggest features
  • 🐛 Report bugs
  • 📢 Share with friends if you find it useful