@khemsok/tunl 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -8
- package/dist/cli.js +624 -361
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -37,11 +37,12 @@ The art is procedurally generated and animated every 800ms — stars twinkle, wi
|
|
|
37
37
|
|-----|--------|
|
|
38
38
|
| `space` | Start / pause / resume |
|
|
39
39
|
| `r` | Stop session (back to idle) |
|
|
40
|
-
| `q` | Quit
|
|
40
|
+
| `q` | Quit |
|
|
41
41
|
| `+/-` | Adjust time by 5 min (before starting) |
|
|
42
42
|
| `s` | Edit blocked sites |
|
|
43
43
|
| `t` | Change art theme |
|
|
44
|
-
| `
|
|
44
|
+
| `i` | View focus stats |
|
|
45
|
+
| `Ctrl+C` | Force quit from any screen |
|
|
45
46
|
|
|
46
47
|
## CLI Flags
|
|
47
48
|
|
|
@@ -51,13 +52,15 @@ tunl --duration 45 # 45 minute session
|
|
|
51
52
|
tunl --block "site.com" # add extra sites to block
|
|
52
53
|
tunl --sites "a.com,b.com" # set the full blocklist
|
|
53
54
|
tunl --noblock # timer + art only, no blocking
|
|
55
|
+
tunl --stats # show focus stats and streaks
|
|
54
56
|
tunl --config # show saved config
|
|
55
57
|
tunl --reset # reset config, re-run onboarding
|
|
58
|
+
tunl --help # show usage help
|
|
56
59
|
```
|
|
57
60
|
|
|
58
61
|
## How blocking works
|
|
59
62
|
|
|
60
|
-
tunl appends entries to `/etc/hosts` mapping blocked domains to `
|
|
63
|
+
tunl appends entries to `/etc/hosts` mapping blocked domains to `0.0.0.0`. This requires sudo access — you'll be prompted before the timer starts.
|
|
61
64
|
|
|
62
65
|
Sites are unblocked when:
|
|
63
66
|
- The session completes
|
|
@@ -65,11 +68,6 @@ Sites are unblocked when:
|
|
|
65
68
|
- You quit with `q` or `Ctrl+C`
|
|
66
69
|
- If the process crashes, the next run detects stale entries and cleans up
|
|
67
70
|
|
|
68
|
-
**Note:** If your browser uses DNS-over-HTTPS (Chrome, Arc, Firefox), you need to disable it for blocking to work:
|
|
69
|
-
- **Chrome/Arc:** `chrome://settings/security` or `arc://settings/privacy` → turn off "Use secure DNS"
|
|
70
|
-
- **Firefox:** Settings → Privacy & Security → DNS over HTTPS → Off
|
|
71
|
-
- **Safari:** Works by default
|
|
72
|
-
|
|
73
71
|
## Config
|
|
74
72
|
|
|
75
73
|
Preferences are saved to `~/.tunl.json` after first run. Edit with `tunl --config` to view, `tunl --reset` to start fresh, or press `s`/`t` in the app.
|