TimePulse ⏱️

English | 中文版

---

TimePulse is a sleek, modern desktop reminder and countdown application built for Windows 10 & 11 using Electron. Designed with a dark minimalist aesthetic (Slate / Indigo / Emerald gradient scheme), TimePulse offers high-precision time synchronization, customizable time bases, floating countdown overlays, and flexible recurring reminder schedules.

📸 Screenshots

✨ Key Features

• ** Modern Dark UI**: Crafted with smooth animations, custom scrollbars, and premium dark theme styling powered by Inter & Outfit Google Fonts.
• ** Dual Time Base & High-Precision Synchronization**:
  • Seamlessly switch between System Local Time and Beijing Time (UTC+8).
  • Multi-source HTTP time calibration (Suning, Taobao, WorldTimeAPI) backed up by native Node.js NTP UDP querying for high accuracy regardless of system clock offset or time zone.
• ** Desktop Floating Countdown Window**:
  • Frameless, semi-transparent floating window positioned at the bottom right corner of your screen.
  • Shows real-time countdowns for imminent or selected tasks.
  • Interactive alarm state with direct Acknowledge/Complete and Snooze (5 min) controls.
  • Supports manual closing/hiding and easy restoration.
• ** 60-Second Urgent Focus Mode**:
  • Imminent tasks trigger an animated circular progress ring and millisecond-accurate display on the main window for extreme urgency.
• ** Comprehensive Alerting & Notifications**:
  • Force Foreground (Bring to Front): Automatically restores and brings the window to top when a reminder expires.
  • Native Windows Toast Notifications: Integrated with Win10/11 Notification Center even when minimized to tray.
  • Interactive Modal Alerts: Popup modals with sound effects and quick Snooze capabilities.
• ** Flexible Schedule & Recurrence Types**:
  • One-Time Reminders: Quick presets (5m, 10m, 15m, 30m) or specific date & time selection.
  • Interval Recurrence: Repeat every N minutes, hours, days, months, or years.
  • Fixed Recurrence: Daily, Weekly, or Monthly scheduled alerts.
• ** Multi-Dimensional Task Management**:
  • Filter tasks by Latest, All, or Pending.
  • Dynamic editing of existing tasks (title, time, recurrence mode, time base).
  • One-click removal of completed tasks.
• ** System Tray & Auto-Launch**:
  • Minimizes silently to system tray for unobtrusive background operation.
  • Toggle Run on Startup (Auto Launch) directly from settings.
  • Single-instance lock to prevent duplicate app instances.

🛠️ Tech Stack

• Framework: Electron (v28+)
• Frontend: HTML5, CSS3 (Vanilla CSS, CSS Grid/Flexbox), JavaScript (ES6+)
• Networking/Protocols: Native UDP (dgram) for NTP synchronization, Fetch API for HTTP time services
• Typography: @fontsource/inter, @fontsource/outfit
• Packaging: electron-builder (NSIS Installer & Portable Executable)

🚀 Getting Started

Prerequisites

• Node.js (v16.x or higher recommended)
• npm (v7.x or higher)

Installation & Setup

1. Clone the repository:

   git clone https://github.com/chgblog/TimePulse.git
   cd TimePulse

2. Install dependencies:

   npm install

3. Run in Development mode:

   npm start

Building Executables

To package the application into Windows installers (NSIS setup & portable .exe):

npm run build

Output files will be available in the dist/ directory.

📄 License

This project is licensed under the Non-Commercial License.

• Personal & Non-Commercial Use: Free to download, use, learn, and modify.
• Commercial Restriction: Any commercial usage, resale, or integration into paid products without explicit written permission from the author is strictly prohibited.
• For full details, please refer to the LICENSE file.