Procrastiproxy is a simple, configurable proxy that helps you focus by blocking distracting websites.
curl https://raw.githubusercontent.com/zackproser/procrastiproxy/main/install.sh | bash
Example: block reddit and twitter during work hours
procrastiproxy --block reddit.com,twitter.com
Procrastiproxy implements an in-memory, mutable list for tracking hosts that should be blocked. This in-memory list allows for fast (O(1) or "constant time") look-ups of blocked hosts.
graph TD
A[User] -->|Itches to browse something distracting| B(GET reddit.com/)
B --> C(Procrastiproxy)
C --> D{Should this request be allowed?}
D -->|It's not working hours| E(Allow Request)
D -->|It's time to work!| F(Access denied!)
Install with one command
To install procrastiproxy as a command-line interface (CLI) tool, you can execute the install script:
curl https://raw.githubusercontent.com/zackproser/procrastiproxy/main/install.sh | bash
Install as a library
You can import procrastiproxy into your own project:
import github.com/zackproser/procrastiproxyInstall via Go
You can install and use procrastiproxy as a command line interface (CLI) tool:
go install github.com/zackproser/procrastiproxyBuild from source and run locally
go build -o procrastiproxy ./cmd
./procrastiproxy --port 8001
The block list is kept in-memory and is implemented as a map for fast lookups. You can set your baseline block list in .procrastiproxy.yaml. It can be modified at runtime via the admin control endpoints described below.
Make a request to the <server-root>/admin/ path, passing either block or unblock followed by a host, like so:
curl http://localhost:8001/admin/block/reddit.com
curl http://localhost:8001/admin/unblock/reddit.com
If a request is made to procrastiproxy within the configured office hours, the request will be examined and blocked if its host is on the block list. If a request is made to procrastiproxy outside of the configured office hours, it will be allowed.
Procrastiproxy comes complete with tests to verify its functionality.
go test
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent