https://github.com/efeckc17/pulsetimer
A modern work timer application with customizable work-break intervals, desktop notifications, and clean UI..
https://github.com/efeckc17/pulsetimer
css html5 javascript open-source timer-application timer-clock timer-website web-application
Last synced: 2 days ago
JSON representation
A modern work timer application with customizable work-break intervals, desktop notifications, and clean UI..
- Host: GitHub
- URL: https://github.com/efeckc17/pulsetimer
- Owner: Efeckc17
- License: apache-2.0
- Created: 2025-07-08T12:11:08.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-08T12:56:53.000Z (10 months ago)
- Last Synced: 2025-07-08T14:04:01.034Z (10 months ago)
- Topics: css, html5, javascript, open-source, timer-application, timer-clock, timer-website, web-application
- Language: JavaScript
- Homepage: https://timer.toxi360.org
- Size: 296 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://timer.toxi360.org)**
## ✨ 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](https://timer.toxi360.org) to use PulseTimer directly in your browser. No installation required!
### Local Installation
1. **Clone the repository:**
```bash
git clone https://github.com/Efeckc17/PulseTimer.git
cd PulseTimer
```
2. **Install dependencies:**
```bash
npm install
```
3. **Set up AI (optional):**
```bash
echo "OPENROUTER_API_KEY=your_key_here" > .env
```
4. **Start the server:**
```bash
npm start
```
5. **Open your browser and visit:**
```
http://localhost:5678
```
**AI Setup (Optional):** Get a free API key from [OpenRouter](https://openrouter.ai) 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
- ⭐ Star the repo
- ☕ [Buy me a coffee](https://buymeacoffee.com/toxi360)
- 🐛 Report issues
## 📜 License
PulseTimer is licensed under the [Apache License 2.0](LICENSE).
---
**Made with ❤️ by [@Efeckc17](https://github.com/Efeckc17)**