Skip to content

Readme.md

Latest commit

 

History

History
169 lines (82 loc) · 3.18 KB

Readme.md

File metadata and controls

169 lines (82 loc) · 3.18 KB

Focus Time CLI ⏱️

A command-line productivity app for developers who prefer ctrl+c over clicking buttons. Because who needs GUIs when you've got 256 colors of terminal glory?

Features ✨

  • Project Management: Create and organize your projects (both real and imaginary)

  • Task Tracking: Keep tabs on what you're avoiding

  • Focus Timer: Pomodoro technique without the tomato

  • Data Persistence: Your procrastination patterns saved in JSON for future analysis

  • Audible Alerts: Annoying beeps to match your internal panic

Installation 🛠️

Prerequisites

  • C++17 compatible compiler

  • nlohmann/json library

Linux (Debian/Ubuntu)

sudo  apt-get  install  nlohmann-json3-dev  g++

git  clone  https://github.com/Tacit1/focustimer.git

cd  focustimer

g++  -std=c++17  main.cpp  Project.cpp  Task.cpp  FileManager.cpp  -o  focustimer  -lstdc++fs

macOS

brew  install  nlohmann-json

git  clone  https://github.com/yourrepo/focustimer.git

cd  focustimer

g++  -std=c++17  main.cpp  Project.cpp  Task.cpp  FileManager.cpp  -o  focustimer

Windows(MinGW)

pacman  -S  mingw-w64-x86_64-nlohmann-json

git  clone  https://github.com/yourrepo/focustimer.git

cd  focustimer

g++  -std=c++17  main.cpp  Project.cpp  Task.cpp  FileManager.cpp  -o  focustimer.exe

How to Use 🤹

Run the program:

./focustimer

Main Menu Options:

1. View existing projects
2. Add new project
3. Select project
4. Exit

Project View Options:

1. List all tasks
2. Add task
3. Choose task for focus session
4. Back to main menu

Focus Session Flow:

-   Select task
    
-   Enter focus duration (minutes)
    
-   Watch the countdown like it's New Year's Eve
    
-   Hear the beeps of accomplishment (or despair)

Data Storage 📂

All your projects and tasks are automatically saved in:

/projects_data/projects.json

Because nothing says "I'm organized" like a JSON file.

FAQ ❓

Q: Why CLI instead of a GUI?
A: Because real developers compile their productivity.

Q: The beep doesn't work on my system!
A: Congratulations! You've discovered why GUIs exist. Use a terminal that supports sounds (ASCII Bell) like iterm2 on macOS.

Q: Can I use this to time my coffee breaks?
A: Absolutely. We support all forms of productive procrastination.

Known Issues 🐛

  • Occasionally makes you feel guilty about your actual productivity

  • Terminal color schemes may reveal your questionable aesthetic choices

  • No dark mode (because your terminal already has one)

Contributing 🛠️

  1. Fork it (because you're avoiding real work anyway)

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -am 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request (and then go back to procrastinating)

License 📜

MIT License - Do whatever you want, just don't blame us when you spend more time customizing this than actually working.