GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - lc/void: Throw distracting sites into the void on Mac

BranchesTags
Open more actions menu

Latest commit

 

History

9 Commits
9 Commits

Folders and files

NameName
Last commit message
Last commit date
.github/workflows
.github/workflows
 
 
cmd
cmd
 
 
internal
internal
 
 
pkg
pkg
 
 
.gitignore
.gitignore
 
 
.golangci.yml
.golangci.yml
 
 
.goreleaser.yaml
.goreleaser.yaml
 
 
LICENSE
LICENSE
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 

Repository files navigation

void

Put distracting sites into the void. Works on macOS.

Void is a lightweight, high-performance domain blocker that operates at the network level using macOS's built-in pf (Packet Filter). It blocks distracting websites by domain, resolving them to IPs and enforcing firewall rules—permanently or temporarily.


Features

  • Block domains with one command
  • Temporary or permanent rules
  • Uses macOS-native pf firewall (no kernel extensions)
  • Automatically re-resolves blocked domains, expires old rules, etc.

Install

go install github.com/lc/void/cmd/void@latest
sudo go install github.com/lc/void/cmd/voidd@latest

Requires Go 1.20+ and root access to run the daemon (voidd).


Usage

Start the daemon (must run as root):

sudo voidd

In a separate terminal, use the CLI:

void block facebook.com        # Permanently block
void block twitter.com 2h      # Temporarily block for 2 hours
void list                      # View all current blocks

Config

By default, configuration is stored in ~/.void/config.yaml:

socket:
  path: /var/run/voidd.socket
rules:
  dns_refresh_interval: 1h
  dns_timeout: 5s

Defaults are sensible if no config file is found.


Architecture

  • cmd/void: User-facing CLI
  • cmd/voidd: Background daemon
  • internal/: Core engine, DNS resolver, rule management, pf integration
  • pkg/api: Minimal HTTP-over-UNIX socket API
  • pkg/client: CLI-to-daemon client

About

Throw distracting sites into the void on Mac

Resources

Readme
MIT license
Activity

Stars

6 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.