📖 User Guide

1. Getting Started

When you first open Event Scheduler, you'll be greeted with the home screen. This is your command center for all scheduled events.

Home screen on first launch

Initial Setup

On first launch, you'll be asked to grant a few important permissions:

• Notifications — Required for reminders and alerts
• Alarms & Reminders — Ensures precise scheduling (Android 12+)
• Display over other apps — Shows the media player and alarm overlays on your lock screen

Navigation

The app has four main sections accessible from the bottom navigation bar:

• Home — View and manage all active events with type filtering
• Reminders — View triggered reminders (active and completed)
• Disabled — View paused/disabled media events
• Settings — App settings and Help/FAQ

2. Understanding Event Types

Event Scheduler supports three core event types, each designed for a different use case.

Choose the event type that fits your need

🔔 Reminder

A simple alert that fires a notification at your scheduled time. Perfect for quick one-off or recurring reminders like "Take medicine" or "Stand up and stretch."

📋 Task

Similar to a reminder, but designed for to-do items. Tasks appear in your list and can be marked as complete when done.

🎵 Media

Plays audio or video at the scheduled time. Supports local files (MP3, MP4, etc.), YouTube videos, and YouPlayer streams. Great for alarms with your favorite music or scheduled announcements.

3. Creating a Reminder or Task

The reminder/task creation screen

1. Tap the + button on the Home screen
2. Select Reminder or Task from the event type picker
3. Enter a title (e.g., "Team meeting") and optional description
4. Set the date and time for when the alert should fire
5. Choose a reminder sound — ringtone, audio file, or record your own voice
6. Adjust the reminder volume (0–100%)
7. Optionally choose a recurrence pattern (Daily, Weekly, Monthly, Yearly)
8. Tap Save to schedule the event

4. Reminder Sound & Voice Recording

Customize how your reminder sounds when it triggers. Choose from system tones, your own audio files, or record a voice memo directly in the app.

🔔 Selecting a Ringtone/Notification Tone

1. In the reminder creation screen, find the Reminder Sound section
2. Tap the Tone button
3. The system ringtone picker opens — browse ringtones, notifications, and alarms
4. Select your preferred tone and confirm

📁 Picking an Audio File

1. Tap the File button in the Reminder Sound section
2. Browse your device storage and select any audio file (MP3, M4A, WAV, etc.)
3. The file will be used as your reminder sound

🎙️ Recording a Voice Memo

1. Tap the Record button — the button turns red indicating recording has started
2. Speak your reminder message into the microphone
3. Tap Stop to finish recording
4. The recorded voice is automatically set as the reminder tone

🔊 Volume Control

Use the volume slider (0–100%) to set how loud the reminder tone plays when triggered. This adjusts the device's alarm stream volume at playback time.

Clearing a Selected Tone

Tap the ✕ button next to the tone name to clear your selection and revert to the default notification sound.

5. Creating a Media Event

Media event creation with file selection and volume control

1. Tap the + button and select Media Event
2. Choose the media source: Local file, YouTube, or YouPlayer
3. For local files: tap the file picker to select one or more audio/video files
4. Adjust the volume slider (0–100%) for playback level
5. Set the date and time for playback
6. Configure recurrence if needed
7. Tap Save

Supported Formats

• Audio: MP3, AAC, OGG, WAV, FLAC, M4A
• Video: MP4, MKV, WebM, 3GP

6. Playback Options

Media events now include a dedicated Playback Options card with advanced controls for how your media plays back.

🔀 Shuffle Mode

When you have multiple files or videos queued, enable Shuffle to randomize the playback order. Each time the event triggers, the queue is played in a different random sequence.

1. Create or edit a Media Event with multiple items in the queue
2. Find the Playback Options card below the queue
3. Toggle Shuffle on
4. Save the event — playback order will be randomized each time it triggers

⏱️ Sleep Timer

Automatically stop playback after a set duration. Ideal for bedtime music or meditation sessions where you don't want media playing indefinitely.

1. In the Playback Options card, find the Sleep Timer row
2. Select a duration: 15m, 30m, 45m, 60m, or 90m
3. Select Off to disable the timer
4. When the timer expires, playback stops and the overlay closes automatically

🎵 Audio-Only Mode (YouPlayer)

For YouPlayer media events, you can enable Audio-Only mode to play just the audio track without showing the video overlay. This saves battery and lets you use other apps while listening.

• Available only for YouPlayer media source
• Audio continues in the background via the foreground service
• Control playback from the notification — no overlay appears on screen
• Great for music, podcasts, lectures, and ambient audio from YouTube

7. Using the YouTube Player

YouTube video playback with overlay controls

Event Scheduler includes a built-in player for YouTube content. You can schedule YouTube videos to play at any time — perfect for morning motivation, news briefings, or ambient music.

1. Create a new Media Event
2. Select YouTube or YouPlayer as the source
3. Paste the YouTube video URL or playlist ID — the app auto-extracts the correct video/playlist ID from any YouTube URL format
4. Video and playlist titles are fetched automatically and displayed alongside IDs for easy identification
5. Queue multiple videos — they auto-advance during playback
6. Set your schedule and volume level
7. Save the event

YouTube vs YouPlayer

• YouTube — Uses the embedded YouTube player with full video controls
• YouPlayer — Built-in player with additional features like audio-only mode, shuffle, and sleep timer

Playlist Support

Add full YouTube playlists by pasting the playlist URL or ID. All videos in the playlist are queued and played in sequence (or shuffled if shuffle mode is enabled).

8. Setting Up Recurring Events

Any event type can be set to repeat automatically. This is ideal for daily alarms, weekly meetings, or monthly reminders.

Available Intervals

• Daily — Repeats every day at the same time
• Weekly — Repeats on the same day each week
• Monthly — Repeats on the same date each month
• Yearly — Repeats once a year

After each trigger, the event automatically reschedules for the next occurrence. You can disable or delete individual events without affecting future ones.

Auto-Recovery

If a recurring event is missed (device was off, battery optimization interfered), the app automatically recovers and reschedules it for the next valid occurrence. A daily background worker checks for any missed recurring events and brings them back on track.

9. Managing Your Events

Home screen with active events

Editing an Event

• Tap on any event card to open it for editing
• Make your changes (time, title, media, recurrence, etc.)
• Tap Save to apply

Deleting an Event

• Swipe the event card to the left to reveal the delete action
• Or tap the event and use the delete option inside

Enabling / Disabling

Each event card has a toggle switch:

• Reminders & Tasks: Disabling treats it as completed — it moves to the Reminders screen and auto-deletes after 7 days
• Media Events: Disabling pauses the event — it moves to the Disabled tab and can be re-enabled later

10. Reminders Screen

Reminder screen

The Reminders tab shows all reminders and tasks that have been triggered. This gives you a history of what's fired recently.

How It Works

• When a reminder fires (or you manually disable it), it appears here
• Active reminders (recurring) are shown at the top — they'll fire again at the next scheduled time
• Completed reminders (one-time) are shown at the bottom with strikethrough text and muted styling
• Only Edit and Delete icons are displayed for a clean interface

Auto-Cleanup

Completed reminders are automatically deleted after 7 days. No manual cleanup needed.

11. Filtering Events on Home Screen

The Home screen now includes radio button filters to quickly narrow down your event list by type.

Available Filters

• All (default) — Shows all active events
• Reminder — Shows only reminder events
• Media — Shows only media events
• Task — Shows only task events

The filter appears as a row of radio buttons at the top of the event list. Tap any option to instantly filter the display. "All" is selected by default when you open the app.

12. Disabled Events

The Disabled tab shows all paused events

Disabled events are media events you've temporarily paused. They won't trigger at their scheduled time, but you can re-enable them anytime.

• Navigate to the Disabled tab from the bottom navigation
• Tap the re-enable button and set a new date/time to reschedule
• The event will be rescheduled and appear back on the Home screen

Auto-Cleanup

Events that remain disabled for more than 30 days are automatically deleted to keep your list clean. Re-enable events before then if you plan to use them again.

13. Background Playback

Media continues playing in the background with notification controls

Media events play through a foreground service, meaning audio and video continue even when your screen is off or you're using other apps.

How It Works

• When a media event triggers, a persistent notification appears with playback controls
• You can pause, skip, or stop from the notification
• An overlay player appears on your lock screen (if overlay permission is granted)
• Playback stops automatically when all files in the playlist finish

14. Permissions & Troubleshooting

Required Permissions

• Notifications — Show alerts and playback controls
• Exact Alarms — Fire events at precise times (Android 12+)
• Microphone — Record voice memos for reminders
• Display over other apps — Show overlay player and alarm UI
• Disable battery optimization — Prevent the system from killing the app

Device-Specific Settings

Some manufacturers (Xiaomi, Vivo, POCO, Oppo, Realme, Samsung) have extra restrictions:

• Xiaomi / POCO: Enable Autostart, lock app in recent tasks, grant "Display pop-up windows" and "Show on Lock screen"
• Vivo: Enable Autostart in iManager > App Manager
• Samsung: Disable "Put app to sleep" in battery settings
• Oppo / Realme: Enable Autostart and allow background activity

Events Not Firing?

1. Check that the event is enabled (toggle is on)
2. Verify the scheduled time hasn't already passed
3. Disable battery optimization for Event Scheduler
4. Make sure Do Not Disturb is off
5. Grant all requested permissions
6. On Android 12+: Go to Settings → Apps → Event Scheduler → Alarms & Reminders → Allow

After Device Restart

Event Scheduler automatically reschedules all active events after a reboot. If events aren't firing after restart:

• Make sure Autostart is enabled (Xiaomi/Vivo/Oppo devices)
• Don't force-stop the app
• Disable battery optimization