The largest file in phone_focus_mode, and the last one blocking deploy.sh:
splitting it grows deploy.sh's two hardcoded lists, so those lists are only
final now. All 55 functions moved verbatim.
Three while-read loops were audited before extraction. Two call pm in their
bodies and moved untouched. The third, iter_whitelist_packages, is fed by a
pipe from printf and reads nothing from stdin -- already safe, and now said
so in ctl_usage.sh's header so the distinction is not lost by a later editor
who has only read the warning in daemon_apps.sh.
136 assertions and 22 mutations, all killed. Three survived the first run
and every one was a defect in MY OWN tests, not in the subject:
- cmd_status carries a THIRD copy of the Haversine, and I had asserted
only that it printed "some number". A wrong Earth radius sailed through.
Now the value is checked against a seeded fix ~4.3 km from home.
- the two whitelist filters were each tested with input the OTHER filter
also rejects, so either could be deleted with nothing failing. Fixed
with a punctuation-free undotted token (only the dot check rejects it)
and a dotted token carrying an illegal character (only the charset check
does), making each independently observable.
That last investigation turned up dead code: the `#*)` case arm is provably
equivalent, because `set -- $line` makes a comment's first token "#", which
the dot check already rejects. Removed rather than covered by a test that
cannot fail.
Coverage is NOT 100% and the real numbers are in the evidence: 41.79% to
92.98% across the eight, up from 5-22%. Unlike the daemon split, most of
what remains is genuinely untested -- the per-enforcer status blocks that
print mount state, APK hashes and offload settings, each needing its own
device fixture. The mutations prove the assertions that exist are load-
bearing; they do not prove those branches work.
jscpd checked in a clean worktree at 1.57%: eight files each carrying a
near-identical start/stop/status trio is exactly what that gate is for, so
the tests drive the trios through tables instead of repeating them.
Two drift hazards recorded, not fixed: ctl_is_curfew_now duplicates
daemon_location.sh's is_curfew_now (pinned by an agreement test across every
boundary minute), and cmd_status's awk is the third Haversine.
Over-cap count 17 -> 16. deploy.sh is the last one here.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011w2Pj4Ek3ZNMQVYcFHgXDY
|
||
|---|---|---|
| .. | ||
| docs | ||
| focus_status_app | ||
| lib | ||
| systemd | ||
| backup_manifest.sh | ||
| batch3_bloatware_uninstall.sh | ||
| config_curfew.sh | ||
| config_dns.sh | ||
| config_launcher.sh | ||
| config_paths.sh | ||
| config_tether.sh | ||
| config.sh | ||
| ctl_curfew.sh | ||
| ctl_daemon.sh | ||
| ctl_dns.sh | ||
| ctl_hosts.sh | ||
| ctl_launcher.sh | ||
| ctl_tether.sh | ||
| ctl_usage.sh | ||
| ctl_workout.sh | ||
| curfew_enforcer.sh | ||
| curfew_net.sh | ||
| daemon_apps.sh | ||
| daemon_location.sh | ||
| daemon_state.sh | ||
| deploy.sh | ||
| distraction_purge.sh | ||
| dns_enforcer.sh | ||
| dns_iptables.sh | ||
| enable_persistent_adb.sh | ||
| focus_ctl.sh | ||
| focus_daemon.sh | ||
| hosts_enforcer.sh | ||
| hosts_magisk.sh | ||
| hosts_mount.sh | ||
| launcher_enforcer.sh | ||
| magisk_service.sh | ||
| phone_backup.sh | ||
| README.md | ||
| restore_apps.sh | ||
| run_phone.sh | ||
| strip_workout_hosts.py | ||
| tether_enforcer.sh | ||
| tether_iptables.sh | ||
| workout_detector.sh | ||
Phone Focus Mode
Location-based app restriction for a rooted Android phone using wireless ADB.
When within ~500m of home: only whitelisted productive apps remain usable. When outside that radius: all apps work normally.
Requirements
- Rooted phone with Magisk installed
- Wireless ADB enabled (
Settings → Developer options → Wireless debugging) adbinstalled on your PC (sudo apt install adbon Debian/Ubuntu)- GPS/Location enabled on the phone
Setup (first time)
1. Find your home coordinates
Open Google Maps, right-click your apartment → copy the coordinates shown.
2. Edit config_secrets.sh
HOME_LAT="-48.876667" # your latitude
HOME_LON="-123.393333" # your longitude
3. (Optional) Adjust the whitelist in config.sh
To find the exact package name of any app:
./deploy.sh <phone_ip> --find-pkg stronglift
./deploy.sh <phone_ip> --find-pkg anki
./deploy.sh <phone_ip> --find-pkg pomodoro
Then add the correct package name to WHITELIST in config.sh.
4. Deploy
chmod +x deploy.sh
./deploy.sh 192.168.1.42 # replace with your phone's IP
This:
- Pushes all scripts to
/data/local/tmp/focus_mode/on the device - Installs a Magisk
service.dscript so the daemon auto-starts on boot - Starts the daemon immediately
Usage
./deploy.sh <ip> --status # Current mode, location, distance from home
./deploy.sh <ip> --log # View recent daemon log
./deploy.sh <ip> --list # List all apps + whitelist status
./deploy.sh <ip> --enable # Force focus mode ON (for testing)
./deploy.sh <ip> --disable # Force focus mode OFF
./deploy.sh <ip> --stop # Stop daemon entirely (restores all apps)
./deploy.sh <ip> --start # Start daemon
./deploy.sh <ip> --restart # Restart daemon (picks up config changes)
./deploy.sh <ip> --pull-log # Download log file to your PC
How it works
Every 60 seconds:
get_location() ─── dumpsys location ──► lat,lon
│
▼
calc_distance() ─── Haversine formula ──► meters
│
├── within radius? ──► enable_focus_mode()
│ pm disable-user all non-whitelisted apps
│ record which apps were disabled
│
└── outside radius? ──► disable_focus_mode()
pm enable each app in the disabled list
Hysteresis: 50m buffer prevents rapid toggling at the boundary. You must travel
radius - 50m inward to trigger lock, and radius + 50m outward to unlock.
Fail-safe: If location is unavailable for 5 consecutive checks (~5 minutes), focus mode is automatically disabled so you can't be locked out.
State persistence: The daemon records exactly which apps it disabled
(in /data/local/tmp/focus_mode/disabled_by_focus.txt), so it never accidentally
re-enables apps that were already disabled by the user before focus mode ran.
On-device control (without PC)
From a root terminal app (e.g. Termux + tsu):
su --mount-master -c 'sh /data/local/tmp/focus_mode/focus_ctl.sh status'
su --mount-master -c 'sh /data/local/tmp/focus_mode/focus_ctl.sh disable'
Why --mount-master: MagiskSU puts each su -c session in an isolated
mount namespace by default, so bind mounts made by the hosts enforcer would be
invisible (and /data/adb/focus_mode/* checks would fail due to SELinux
interactions). --mount-master joins the global namespace where the daemons
(started from Magisk service.d at boot) actually live. The boot autostart
script doesn't need this flag because post-fs-data already runs there.
File layout
| File | Purpose |
|---|---|
config.sh |
Coordinates, radius, whitelist, constants |
focus_daemon.sh |
Main daemon — runs on device, loops every 60s |
focus_ctl.sh |
Control utility — runs on device |
curfew_enforcer.sh |
Night-curfew enforcer — grayscale + DND + optional net |
hosts_enforcer.sh |
Bind-mounts hosts.canonical over /system/etc/hosts |
magisk_service.sh |
Magisk boot hook → auto-starts both daemons |
deploy.sh |
PC-side ADB deployment and control script |
Hosts hardening
A second daemon, hosts_enforcer.sh, locks the phone's /system/etc/hosts
to the same blocklist installed by linux_configuration/hosts/install.sh
on the PC. Three layers:
- Canonical copy at
/data/adb/focus_mode/hosts.canonicalischattr +i. - It is bind-mounted read-only over
/system/etc/hostsat boot. - A watchdog verifies a sha256 every 15 seconds and restores on mismatch.
This blocks the common echo > /etc/hosts one-liner from a terminal app.
It is NOT a guarantee against a determined root user on the device itself —
a real "impossible without USB" gate would require removing su access,
which would break the rest of this system. The watchdog at least ensures
tampering is logged and reverted within ~15s.
Status and logs:
./deploy.sh <ip> --hosts-status
./deploy.sh <ip> --hosts-log
Periodic rescan / Play Store
The focus daemon now re-scans every tick (not just on first entry). If
you re-enable an app via Play Store or pm enable, it gets re-disabled
within CHECK_INTERVAL_FOCUS seconds. com.android.vending (Play Store),
com.*.packageinstaller, and popular terminal apps are also uninstalled
--user 0 in focus mode to close the usual bypass paths. Google Play
Services (com.google.android.gms) is left alone so banking apps work.
More detail
Split out to stay under the 250-line cap.