NotifyPulse 🔔

A background Windows notification app that fires reminders at random intervals with weighted probability — plus exact-time daily triggers.

Features

Feature	Details
Weighted random	`Text \| 40%` – higher % = more likely to be picked
Time triggers	`Text \| 14:30` – fires every day at that exact time
Random interval	10–30 minutes between random notifications
Pause hotkey	Press F13 to pause; queued notifications fire when you unpause
System tray	Runs silently in the tray, right-click to quit or open config
Auto-start ready	Drop the EXE in Windows startup folder

Quick Start

Run from Python

pip install -r requirements.txt
python notifier.py

Build .exe

build.bat

The EXE lands in dist\NotifyPulse.exe.
Copy notifications.txt next to it (or it auto-creates a sample).

notifications.txt Format

# Lines starting with # are comments

# Weighted random entries (percentages should add up to 100, but don't have to)
Take a break and stretch! 🚶 | 35%
Drink some water 💧           | 30%
Check your posture 🧍         | 20%
Deep breath – you got this! 😌| 15%

# Time-based triggers – fire every day at HH:MM
Morning standup ☕             | 09:00
Afternoon focus 🎯             | 14:00
End-of-day wrap-up 📋          | 17:30

Rules

Separator is | (pipe character)
Percentages: 30% — picks proportionally (doesn't need to sum to 100)
Times: HH:MM in 24-hour format
Lines without | get equal weight in random selection
Comments start with #

Hotkey

Key	Action
F13	Toggle pause/unpause

Paused? Notifications are queued. When you unpause, all queued messages fire immediately (with a 1.5s gap between them).

Auto-start with Windows

Press Win + R → type shell:startup → Enter
Drop a shortcut to NotifyPulse.exe in that folder
It will launch silently on every login

Troubleshooting

Notifications not showing?

Check Windows Focus Assist / Do Not Disturb is off
Windows 10/11 only (winotify requires it)

F13 not working?

Run the app as Administrator (keyboard hook needs elevated rights sometimes)
Or remap a key to F13 using AutoHotkey / your keyboard software

Build fails?

Make sure Python 3.10+ is installed
Run build.bat from the project folder

2.7 KiB Raw Permalink Blame History Unescape Escape