216 lines
8.6 KiB
Markdown
216 lines
8.6 KiB
Markdown
```
|
|
█████╗ ████████╗██╗ ██╗
|
|
██╔══██╗╚══██╔══╝██║ ██╔╝
|
|
███████║ ██║ █████╔╝
|
|
██╔══██║ ██║ ██╔═██╗
|
|
██║ ██║ ██║ ██║ ██╗
|
|
╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝
|
|
ANDROID TOOLKIT — v1.0.5
|
|
```
|
|
|
|
> All-in-one ADB command centre for Android power users, security researchers, and bug hunters.
|
|
> Built with Go + React via Wails. Runs natively on Linux, Windows, and macOS.
|
|
> Uses your system ADB — no bundled binaries, no mystery executables.
|
|
|
|
---
|
|
|
|
```
|
|
[ DOWNLOADS ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
| Platform | Format | Install |
|
|
|-----------------------|-------------|--------------------------------------------------|
|
|
| Linux — Debian/Ubuntu | `.deb` | `sudo dpkg -i ATK-*.deb` |
|
|
| Linux — any distro | `.AppImage` | `chmod +x ATK-*.AppImage && ./ATK-*.AppImage` |
|
|
| Windows | `.exe` | Run directly |
|
|
| macOS 11.0+ | `.dmg` | Unsigned — see note below |
|
|
|
|
**[→ Latest Release](https://github.com/jegly/ATK/releases/latest)**
|
|
|
|
**Linux requirements**
|
|
```bash
|
|
sudo apt install adb fastboot libwebkit2gtk-4.1-0
|
|
```
|
|
|
|
**macOS — Gatekeeper bypass**
|
|
```bash
|
|
xattr -rd com.apple.quarantine /Applications/ATK.app
|
|
# or: System Preferences → Security & Privacy → Open Anyway
|
|
```
|
|
|
|
---
|
|
|
|
```
|
|
[ MODULES ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
```
|
|
┌─────────────────────┬────────────────────────────────────────────────────┐
|
|
│ MODULE │ DESCRIPTION │
|
|
├─────────────────────┼────────────────────────────────────────────────────┤
|
|
│ Dashboard │ Device info, wireless ADB, reboot controls │
|
|
│ File Explorer │ Push, pull, rename, delete, batch export │
|
|
│ Package Manager │ Install, uninstall, enable, disable, pull APK │
|
|
│ Debloater │ 2157 packages — Samsung, Xiaomi, Google, 10+ OEMs │
|
|
│ Live Logcat │ Real-time streaming, level filter, tag filter │
|
|
│ App Inspector │ Permissions, components, certs, pinning check │
|
|
│ Certificate Manager │ Install/remove user CAs for HTTPS interception │
|
|
│ Device Backup │ adb backup with app selection and restore │
|
|
│ Prop Editor │ Read/write all 300+ system properties │
|
|
│ Shell Terminal │ adb shell and host commands, command history │
|
|
│ Utilities │ 487 commands across 15 categories │
|
|
│ Flasher │ Fastboot partition flash, getvar, sideload │
|
|
│ Pixel Factory Flash │ Full factory image flash from flash-all.sh │
|
|
└─────────────────────┴────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
```
|
|
[ SECURITY ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
```
|
|
NO BUNDLED BINARIES
|
|
ATK has no bin/ directory. It resolves adb and fastboot from your system
|
|
PATH — installed via apt, Homebrew, or Android SDK. The Settings view
|
|
displays the full path and SHA-256 of whichever binary is in use so you
|
|
can verify it against Google's published platform-tools checksums.
|
|
|
|
NO SHELL STRING BUILDING
|
|
Every command uses exec.Command(binary, arg1, arg2, ...) with discrete
|
|
arguments passed directly to execve. There is no shell involved and
|
|
therefore no shell injection surface.
|
|
|
|
INPUT VALIDATION
|
|
Package names, partition names, IP addresses, and remote paths are all
|
|
validated before use. Fastboot flash only accepts a known partition
|
|
allowlist — no arbitrary partition names accepted.
|
|
```
|
|
|
|
---
|
|
|
|
```
|
|
[ DEBLOATER ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
Package database sourced from Universal Android Debloater (UAD-ng). 2,157
|
|
packages across 14 manufacturers and categories, each with safety ratings:
|
|
|
|
```
|
|
SAFE — generally safe to remove
|
|
CAUTION — disable rather than uninstall; may affect device behaviour
|
|
KEEP — do not remove; will break core system functionality
|
|
```
|
|
|
|
Coverage: Samsung · Xiaomi · OnePlus/Oppo · Huawei · Sony · Motorola · LG
|
|
Nokia/HMD · Asus · Realme · Google · Carriers · AOSP · Misc
|
|
|
|
---
|
|
|
|
```
|
|
[ PIXEL FACTORY FLASH ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
ATK reads `flash-all.sh` directly from inside the factory image zip and
|
|
executes the correct sequence — no hardcoded partition order. Options:
|
|
|
|
```
|
|
--wipe Wipe userdata (-w flag on fastboot update)
|
|
--disable-verity For Magisk / root setups
|
|
--disable-verif Paired with disable-verity
|
|
--force Bypass anti-rollback (use with caution)
|
|
--slot all Flash both A and B slots
|
|
```
|
|
|
|
Download factory images from: https://developers.google.com/android/images
|
|
|
|
---
|
|
|
|
```
|
|
[ BUILD FROM SOURCE ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
**Prerequisites — Ubuntu/Debian**
|
|
```bash
|
|
sudo apt install -y build-essential pkg-config libgtk-3-dev \
|
|
libwebkit2gtk-4.1-dev libayatana-appindicator3-dev adb fastboot
|
|
|
|
# Go 1.23
|
|
wget https://go.dev/dl/go1.23.0.linux-amd64.tar.gz
|
|
sudo rm -rf /usr/local/go
|
|
sudo tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz
|
|
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bashrc
|
|
source ~/.bashrc
|
|
|
|
# Node + pnpm + Wails
|
|
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
|
|
sudo apt install -y nodejs
|
|
sudo npm install -g pnpm
|
|
go install github.com/wailsapp/wails/v2/cmd/wails@latest
|
|
```
|
|
|
|
**Build**
|
|
```bash
|
|
git clone https://github.com/jegly/ATK
|
|
cd ATK
|
|
go mod tidy
|
|
cd frontend && pnpm install && cd ..
|
|
wails build -tags webkit2_41
|
|
./build/bin/ATK
|
|
```
|
|
|
|
**Dev mode (hot reload)**
|
|
```bash
|
|
wails dev -tags webkit2_41
|
|
```
|
|
|
|
**Package as .deb**
|
|
```bash
|
|
go install github.com/goreleaser/nfpm/v2/cmd/nfpm@latest
|
|
wails build -tags webkit2_41
|
|
nfpm pkg --packager deb --target build/
|
|
sudo dpkg -i build/atk_*.deb
|
|
```
|
|
|
|
---
|
|
|
|
```
|
|
[ ARCH LINUX ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
A `PKGBUILD` is included in `aur/`. See `aur/README.md` for publishing to
|
|
the AUR. Until then, Arch users can use the `.AppImage` from the releases
|
|
page — no installation required.
|
|
|
|
---
|
|
|
|
```
|
|
[ LICENCE ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
ATK is released under the GNU General Public License v3.0.
|
|
|
|
The debloater package database is from Universal Android Debloater Next
|
|
Generation (GPL-3.0) by the Universal-Debloater-Alliance.
|
|
|
|
See LICENSE for full terms and third-party attributions.
|
|
|
|
---
|
|
|
|
```
|
|
[ ACKNOWLEDGEMENTS ]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
```
|
|
Universal Android Debloater Alliance — debloater package database
|
|
Wails — Go + Web application framework
|
|
PixelFlasher (badabing2005) — Pixel flash sequence reference
|
|
Lucide — icon set
|
|
```
|
|
|
|
---
|
|
|
|
```
|
|
github.com/jegly/ATK
|
|
```
|