An open API service indexing awesome lists of open source software.

https://github.com/thanhtrunggdev/dontbelazy

A personal productivity app that forces you to finish your tasks by whitelisting only work-related apps and websites
https://github.com/thanhtrunggdev/dontbelazy

adhd app-blocker behavioral-psychology deep-work desktop-app distraction-blocker focus habit-tracker motivation pomodoro productivity self-discipline strict-mode website-blocker whitelist

Last synced: about 2 months ago
JSON representation

A personal productivity app that forces you to finish your tasks by whitelisting only work-related apps and websites

Awesome Lists containing this project

README

          

# 🧱 Don't Be Lazy

**Force yourself to get things done by whitelisting only what you need to work.**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Status](https://img.shields.io/badge/status-planning-blue)]()
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)
[![Sponsor](https://img.shields.io/badge/Sponsor-PayPal-00457C?logo=paypal)](https://paypal.me/ntt68)

🌏 **[TiαΊΏng Việt](./README.md)** | **English**

---

## 🎯 The Problem

You sit down to work, open your laptop, and two hours later you realize you've been scrolling through social media and watching YouTube without getting anything done.

**Don't Be Lazy** was built to solve exactly that.

Unlike typical website blockers that are trivially easy to disable, **Don't Be Lazy** operates on a **Whitelist-first** principle: everything is blocked by default, and you explicitly allow only what you need to work.

---

## ✨ Core Features

| Feature | Description |
|---|---|
| πŸ“‹ **Task Management** | Create a to-do list with Pomodoro-style time estimates |
| πŸ”’ **Whitelist per Task** | Each task has its own Whitelist Profile β€” "Code" task allows VS Code, "Study" task allows dictionary app |
| πŸ›‘οΈ **Focus Mode** | Activates a system-level shield blocking all internet and apps outside the Whitelist |
| βš”οΈ **Strict Mode** | Cannot Stop, cannot edit Whitelist, cannot kill app via Task Manager |
| 🧠 **Psychological Tricks** | Friction, Guilt-tripping, Loss Aversion, Implementation Intention |
| πŸ’¬ **Motivation Quotes** | Auto-displays inspiring quotes at 4 strategic moments during your session |
| πŸ“Š **Analytics** | Daily Streak, focus time charts, and "blocked attempt" counters |

---

## 🧠 Behavioral Psychology by Design

> *Don't Be Lazy doesn't just block websites β€” it trains your brain to stay committed.*

- **Implementation Intention:** Before starting, you must manually type your goal commitment (e.g. *"I will finish this feature in 25 minutes"*). Writing it down increases follow-through by ~40%.
- **Friction:** Want to quit early? You have to manually type: *"I am lazy and I accept giving up"* before the Stop button works.
- **Loss Aversion:** Your Streak counter is always visible. Quitting = Streak resets to 0. The brain hates loss more than it loves gain.
- **Guilt-tripping:** A red warning screen guilt-trips you with *"You only have 10 minutes left β€” do you really want to throw away all that effort?"* before allowing exit.

---

## πŸ–₯️ Platform

- Windows (primary target)
- macOS (planned)

---

## πŸ—οΈ Architecture Philosophy

- **Single-user, Offline-first:** No accounts, no cloud sync. Your data stays on your machine.
- **Privacy by design:** Zero network connections made by the app itself. All task data, whitelist configs, and session history stored in a local SQLite/JSON database.
- **System-level blocking:** Modifies the OS `hosts` file and/or uses a local proxy to block sites across all browsers (requires Admin/Root privilege).
- **Tamper-proof:** In Strict Mode, the app resists being killed via Task Manager and prevents uninstallation mid-session.

---

## πŸ“Š How It Works

```
[User creates Task] β†’ [Assigns Whitelist Profile] β†’ [Types commitment]
↓
[Start Focus Mode]
↓
[System blocks all apps/websites not in the Profile]
↓
[Psychological tricks fire at strategic moments]
↓
[Session ends] β†’ [Streak +1, Analytics updated]
```

---

## πŸ—‚οΈ Documentation

- [πŸ“„ BA Document](./docs/ba_document.md) β€” Business analysis, features, system requirements (Vietnamese)
- [πŸ“‹ Use Cases](./docs/use_cases.md) β€” Detailed use case flows UC01–UC06 (Vietnamese)
- [πŸ“ Changelog](./CHANGELOG.md) β€” Release history
- [🀝 Contributing](./CONTRIBUTING.md) β€” How to contribute
- [πŸ”’ Security](./SECURITY.md) β€” Security policy and vulnerability reporting

---

## πŸš€ Project Status

Currently in **Planning & Design** phase. All BA documentation and Use Cases are finalized. Development begins next.

**Roadmap:**
- [x] Business Analysis document
- [x] Use Case documentation (UC01–UC06)
- [ ] Tech stack decision (leaning towards C# WPF + Rust)
- [ ] UI/UX wireframes
- [ ] Core engine: system-level blocker
- [ ] MVP release

---

## 🀝 Contributing

Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting a Pull Request.

---

## πŸ’– Support the Project

If you find this project useful and want to support its development, feel free to buy me a coffee!

[![Sponsor via PayPal](https://img.shields.io/badge/Donate-PayPal-00457C?style=for-the-badge&logo=paypal)](https://paypal.me/ntt68)

---

## πŸ“œ License

Distributed under the [MIT License](./LICENSE). Β© 2026 ThanhTrunggDEV