Skip to content

Efeckc17/PulseTimer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PulseTimer 🤖

A modern work timer with AI-powered recommendations. Get smart timer settings based on your goals, plus beautiful design and focus features.

🌐 Try PulseTimer Online

Timer Interface AI Assistant Break Time Settings Panel

✨ Features

  • 🤖 AI Assistant - Describe your goal, get smart timer recommendations
  • 🎯 8 Presets - Study, Deep Work, Creative, Coding, Meeting, Writing, Research, Exercise
  • ⏱️ Flexible Timer - Custom work/break intervals, session names, progress tracking
  • 🔔 Smart Notifications - Desktop alerts and audio feedback
  • 🎨 Modern Design - Clean interface, responsive for all devices
  • 📊 Session History - Track your daily productivity
  • 🔒 Privacy Focused - All data stays local, timer hide mode

🚀 Quick Start

Online Usage

Visit timer.toxi360.org to use PulseTimer directly in your browser. No installation required!

Local Installation

  1. Clone the repository:
git clone https://github.com/Efeckc17/PulseTimer.git
cd PulseTimer
  1. Install dependencies:
npm install
  1. Set up AI (optional):
echo "OPENROUTER_API_KEY=your_key_here" > .env
  1. Start the server:
npm start
  1. Open your browser and visit:
http://localhost:5678

AI Setup (Optional): Get a free API key from OpenRouter for AI recommendations. Works fine without it too!

🛠️ Tech Stack

  • Frontend: HTML5, CSS3, JavaScript (ES6 modules)
  • Backend: Node.js, Express
  • AI: OpenRouter API (GPT-3.5-turbo)
  • Audio: Web Audio API
  • Notifications: Web Notifications API
  • Security: Helmet.js

🚀 Usage

  1. AI Assistant: Click the floating button → describe your goal → get recommendations
  2. Manual Setup: Set work duration, break intervals, session name
  3. Start Timer: Play/pause/reset, track progress
  4. Smart Breaks: Auto breaks with notes, skip if needed
  5. History: Check your daily sessions in settings

🤝 Contributing

Found a bug? Want a feature? PRs welcome!

  1. Fork the repo
  2. Make your changes
  3. Submit a PR

💝 Support

📜 License

PulseTimer is licensed under the Apache License 2.0.


Made with ❤️ by @Efeckc17