Skip to content

juke32/PyCronVideoAlarm

Repository files navigation

PyCron Video Alarm

A cross-platform video alarm clock that wakes you up with videos, audio, and custom automation sequences — scheduled through your OS natively (cron on Linux, Task Scheduler on Windows).

License Platform Ko-fi


✨ What It Does

  • 🎬 Play videos as alarms — launch any video file at a scheduled time using MPV
  • 🔊 Play audio — wake up to music, sounds, or recorded voice clips
  • 📋 Alarm Sequences — chain actions together (play video → open website → dim screen → etc.)
  • 🕐 Sleep Cycle Calculator — calculates optimal wake times in 90-minute cycles
  • 🔁 Recurring Alarms — set alarms for specific days of the week, or one-time only
  • 🌙 Sleep Mode — dim/black screen overlay with keep-awake to assist sleeping
  • 💡 Brightness Control — dim the display as part of a sequence (Linux + Windows)
  • 🏠 Native OS Scheduling — uses cron on Linux, Task Scheduler on Windows (no background process needed on windows, on linux it will need an application open on the user to run the tasks)
  • 🎨 Themes — multiple dark/light themes

📂 Folder Structure

Place the executable (or run from source) with this layout. The app creates missing folders automatically on first run.

PyCronVideoAlarm/
│
├── PyCronVideoAlarm_Linux    ← Main executable (Linux)
├── PyCronVideoAlarm_Windows.exe  ← Main executable (Windows)
├── settings.json             ← Auto-generated on first run
│
├── sequences/                ← Alarm sequences (.json files)
│   ├── Morning_Routine.json
│   └── Weekend_Wake.json
│
├── audio/                    ← Audio files for sequences
│   ├── Alarm_Clock.mp3
│   └── 00-100_numbers/       ← Drop the "0-100 Audio" pack here
│
└── video/                    ← Video files for sequences
    ├── FunnyFolder/          ← Drop funny video packs here
    └── MotivationFolder/     ← Drop motivational packs here

Note

Sample sequences, audio, and video packs are available as optional downloads on the Releases page. Drop them in the folders above and the included sequences will work immediately.


📖 Installation Guides

Choose your operating system for detailed installation and setup instructions:


🤝 Contributing & Support

🍕 Support on Ko-fi — any amount helps!

Issues, feature requests, and pull requests are welcome on the GitHub Issues.


📄 License

Custom Source-Available License — free for personal and non-commercial use with attribution. Commercial use, resale, and public redistribution of modified versions require permission from Juke32.

About

Video Alarmclock Manager / Task Scheduler - run videos, audio, and programs at specific times in any order you want!

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages