filtre 💡

filtre is a minimalist, professional focus engine for macOS. Designed with a flat aesthetic, it lives in your menu bar and helps you stay in the flow by blocking digital distractions at the system level.

⚡ Features

• Minimalist Widget: A zero-distraction menu bar interface that stays out of your way.
• Smart Profiles: Create up to 6 custom focus profiles with specific blocklists.
• System-level Blocking: Modifies /etc/hosts for robust website blocking that works across all browsers.
• Optimized Performance: Zero bloat, no heavy animations, and low CPU usage.
• Dynamic Icons: Timer controls that adapt their color based on progress for perfect visibility.

🚀 Installation

Via Homebrew

brew install --cask filtre

From Source

1. Clone the repository:

   git clone https://github.com/msrexe/filtre.git
   cd filtre

2. Install dependencies:

   npm install

3. Run as a widget:

   sudo npm run widget

   Note: sudo is required to modify the /etc/hosts file.

🛠 Usage

1. Start the Engine: Launch the app and look for the circle icon in your Menu Bar.
2. Configure Profiles: Go to the settings (shield icon) to define your blocklists (e.g., social media, news, etc.).
3. Engage Focus: Select a profile, set your duration, and hit Play.
4. The Wave: Watch the timer fill with white as your session progresses. Total focus, zero noise.

🤝 Contributing

Contributions are welcome! If you'd like to improve filtre, please feel free to:

1. Fork the project.
2. Create a Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

Distributed under the MIT License. See LICENSE for more information.