Lock Assist 📱🔒

An Android utility app designed for Android 12 (API 31 / Moto G60) that provides a clean, transparent 1×1 Home Screen Widget for instant single-tap lock.

Note on Biometric Unlock: Unlike traditional Device Policy Administrator lock apps, Lock Assist uses AccessibilityService.performGlobalAction(GLOBAL_ACTION_LOCK_SCREEN), allowing you to unlock your phone using Fingerprint or Face Unlock without requiring a PIN/Pattern re-entry.

---

📦 Downloads & Releases

• ⬇️ Direct APK Download: Lock-Assist-v1.4.1.apk
• 🚀 GitHub Releases Page: https://github.com/onizukaTP/Lock-Assist/releases

---

Features

• 🧱 Transparent 1×1 Lock Widget: Crisp vector lock icon with keyhole cutout and 100% transparent background that seamlessly blends into your home screen wallpaper.
• ⚡ Pure Widget Architecture: Zero window overlays, zero touch lag, and zero gesture conflicts.
• 🔑 Biometric Unlock Preserved: Works via GLOBAL_ACTION_LOCK_SCREEN — fingerprint/face unlock works seamlessly without requiring PIN re-entry.
• 🔔 In-App Auto-Update Checker: Checks GitHub Releases automatically on launch and prompts if a new version is available.
• 📳 Haptic Feedback: Subtle vibration on lock.
• 🎨 Material 3 UI: Clean setup interface to check and enable accessibility permissions.

---

Setup & Git Configuration (Personal GitHub onizukaTP)

SSH Config Setup

To push to your personal GitHub repository using the onizukaTP account, ensure your ~/.ssh/config file contains:

# Personal GitHub (onizukaTP)
Host github-personal
    HostName ssh.github.com
    User git
    Port 443
    IdentityFile ~/.ssh/id_github_personal
    IdentitiesOnly yes

Git Remote & Push Commands

To link this repository to your GitHub remote (https://github.com/onizukaTP/Lock-Assist) using your SSH host alias github-personal and push:

# Set SSH remote URL with custom host alias
git remote add origin git@github-personal:onizukaTP/Lock-Assist.git

# Stage and commit files
git add .
git commit -m "Release v1.4.1"

# Push to GitHub
git branch -M master
git push -u origin master

---

Building from Source

Prerequisites

• JDK 17
• Android SDK (API 33)

Build Commands (Windows PowerShell / CMD)

# Build Debug APK
.\gradlew assembleDebug

The compiled APK will be located at:

• releases/Lock-Assist-v1.4.1.apk
• app/build/outputs/apk/debug/app-debug.apk

---

Installation & Usage Instructions

1. Install APK on device via ADB:

   adb install -r releases/Lock-Assist-v1.4.1.apk

2. Enable Accessibility Service:

   • Open Lock Assist app.
   • Tap Enable Accessibility Service button.
   • In Settings under Downloaded Apps / Accessibility, select Lock Assist and turn it ON.

3. Add 1x1 Transparent Lock Widget:

   • Touch & hold your Home Screen wallpaper.
   • Select Widgets -> Lock Assist.
   • Place the Lock Assist Widget anywhere on your home screen.
   • Tap the widget anytime to instantly lock your phone!

---

License

Personal project — maintained by @onizukaTP.