Skip to content

ZenFlow is a minimalist, cross-platform distraction blocker built with JavaFX. It helps you stay productive by temporarily blocking websites from your system's hosts file during timed focus sessions.

License

Notifications You must be signed in to change notification settings

abhie021/ZenFlow_App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZenFlow 🧘‍♂️

ZenFlow is a simple, cross-platform desktop application designed to help you focus by temporarily blocking distracting websites. Built with JavaFX, it provides a minimal and professional interface to manage your focus sessions.

Features

  • Block Distracting Websites: Add any website (e.g., youtube.com, facebook.com) to your blocklist.
  • Timed Focus Sessions: Set a timer for your focus session. Websites are automatically unblocked when the timer finishes.
  • Minimalist UI: A clean, professional, and easy-to-use interface.
  • Cross-Platform: Works on Windows, macOS, and Linux.

How It Works

ZenFlow works by temporarily adding entries to your system's hosts file, which redirects the distracting websites to your local machine (127.0.0.1). Because it modifies a system file, the application must be run with administrator privileges.

Screenshots

Image

How to Run

Prerequisites

  • Java Development Kit (JDK) 17 or higher
  • Apache Maven

Steps

  1. Clone the repository:
    git clone [https://github.com/your-username/zenflow.git](https://github.com/your-username/zenflow.git)
  2. Navigate to the project directory:
    cd zenflow
  3. Run the application using Maven: Important: You must run this command from a terminal with administrator/root privileges.
    mvn javafx:run

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for guidelines.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

ZenFlow is a minimalist, cross-platform distraction blocker built with JavaFX. It helps you stay productive by temporarily blocking websites from your system's hosts file during timed focus sessions.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published