phocus

P H O C U S

An interactive TUI application to manage domain blocking through the system's hosts file. This application provides an easy way to block and unblock domains system-wide using a terminal user interface.

Features

• Interactive terminal user interface
• Real-time domain blocking
• Automatic DNS cache flushing
• Cross-platform support (Windows, macOS, Linux)
• Automatic cleanup on exit

Prerequisites

• Go 1.19 or higher
• Root/Administrator privileges (required for modifying hosts file and flushing DNS)

Installation

For Unix like systems (Linux and MacOS) run the following command:

curl -sSL https://raw.githubusercontent.com/4ster-light/phocus/main/install/install.sh | sudo bash

For Windows run the following command:

[!IMPORTANT] In windows this must be run as administrator

irm https://raw.githubusercontent.com/4ster-light/phocus/main/install/install.ps1 | iex

[!NOTE] This should make the program globally available in your system, if you whish to uninstall, just remove the binary from the path shown in the output of the installation script.

Usage

1. Run the application with administrator privileges:

• On Unix-like systems:

sudo phocus

• On Windows (run Command Prompt as Administrator):

phocus

1. Enter domains to block in the input field
2. Press Enter to block each domain
3. Press ESC to quit (all blocked domains will be automatically unblocked)

How it Works

The application works by:

1. Modifying your system's hosts file (/etc/hosts on Unix-like systems, C:\Windows\System32\drivers\etc\hosts on Windows)
2. Adding entries that redirect specified domains to 127.0.0.1
3. Automatically flushing your system's DNS cache after each modification
4. Cleaning up all modifications when you exit the application

Dependencies

• Bubble Tea - Terminal UI framework
• Bubbles - TUI components
• Lip Gloss - Style definitions

Security Considerations

• The application requires root/administrator privileges to modify the hosts file and flush DNS
• All modifications are reversed when the application exits
• Be careful when blocking domains as it may affect system functionality

License

GNU General Public License v3.0