Skip to content

Add INSTALL.md: a personal sideload runbook - #65

Merged
NireBryce merged 1 commit into
mainfrom
install-runbook
Sep 9, 2026
Merged

NireBryce merged 1 commit into
mainfrom
install-runbook

Conversation

@NireBryce

Copy link
Copy Markdown
Owner

Adds INSTALL.md: build a debug or signed-release APK, get it onto a phone, and grant only the permissions the app actually needs on first launch. Distinct from wiki/testing.md's dev-workflow guide — this is the "get it on my phone" doc — so it's a plain root-level file, not a wiki/ page (no -4llm companion, not tracked by check_wiki.py's phase/freshness checks). Linked from README.md.

Prompted by a security screen of the current codebase — no code changes were needed. Confirmed: no INTERNET permission anywhere (source + merged manifests), SafeLog structurally prevents notification content from reaching logcat (only free-text-free methods, every call site checked), backup/device-transfer excludes everything (allowBackup=false, dataExtractionRules excludes domain="root"), the notification listener is the only non-launcher exported component and requires the signature-only BIND_NOTIFICATION_LISTENER_SERVICE permission, MainActivity sets filterTouchesWhenObscured (tapjacking), rule storage is plain kotlinx.serialization JSON (no reflection/polymorphism deserialization surface), and release signing reads from env vars only (never committed). INSTALL.md's permission-grant guidance and its SECURITY.md/wiki/testing.md references reflect that screen.

wiki/scripts/check_wiki.py check — clean.

🤖 Generated with Claude Code

Build a debug or signed-release APK, get it onto a phone, and grant
only the permissions the app actually needs on first launch. Not a
wiki/ page — this is a one-off "get it on my phone" doc, distinct
from wiki/testing.md's development workflow. Linked from README.md.

Prompted by a security screen of the current codebase (no code
changes needed — no INTERNET permission, SafeLog structurally
prevents notification content from reaching logcat, backup/
device-transfer excludes everything, the notification listener is
the only non-launcher exported component and is signature-permission
gated). INSTALL.md's permission-grant guidance and SECURITY.md
references reflect that screen.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@NireBryce
NireBryce merged commit 6138e78 into main Sep 9, 2026
3 checks passed
@NireBryce
NireBryce deleted the install-runbook branch September 9, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant