feat: add adb scripts

2026-02-02 18:32:18 -08:00
parent f5e8deca59
commit dac875c413
10 changed files with 917 additions and 10 deletions
@@ -0,0 +1,150 @@
+# ADB File Transfer Scripts
+
+Easy-to-use bash scripts for transferring files between your computer and Android device using ADB.
+
+## Prerequisites
+
+- Android Debug Bridge (ADB) installed and in your PATH
+- USB debugging enabled on your Android device
+- Device connected via USB cable
+
+### Installing ADB
+
+**Ubuntu/Debian:**
+```bash
+sudo apt update
+sudo apt install android-tools-adb
+```
+
+**macOS:**
+```bash
+brew install android-platform-tools
+```
+
+**Windows:**
+Download from [Android Developer website](https://developer.android.com/studio/releases/platform-tools)
+
+## Scripts Overview
+
+### 🚀 push.sh - Push files to Android
+Transfer files from your computer to your Android device.
+
+**Usage:**
+```bash
+# Interactive mode (recommended)
+./push.sh
+
+# Direct mode
+./push.sh ~/Documents/file.pdf /sdcard/Download/
+./push.sh ~/Pictures/vacation/ /sdcard/Pictures/
+```
+
+**Features:**
+- Interactive mode with common destination suggestions
+- Automatic path validation
+- Directory creation if needed
+- Progress feedback
+- Support for both files and directories
+
+### 📥 pull.sh - Pull files from Android
+Transfer files from your Android device to your computer.
+
+**Usage:**
+```bash
+# Interactive mode (recommended)
+./pull.sh
+
+# Direct mode
+./pull.sh /sdcard/DCIM/Camera/ ~/Pictures/phone-backup/
+./pull.sh /sdcard/Download/document.pdf ~/Downloads/
+```
+
+**Features:**
+- Browse Android filesystem interactively
+- Quick access to common folders
+- File count and size summary
+- Creates destination directories automatically
+- Support for both files and directories
+
+### 📱 adb-transfer.sh - All-in-One Menu
+Interactive menu system for all file transfer operations.
+
+**Usage:**
+```bash
+./adb-transfer.sh
+```
+
+**Features:**
+- Device status and information display
+- Quick actions (backup photos, screenshots, WhatsApp media)
+- Access to push/pull scripts
+- Device information viewer
+- Beautiful CLI interface
+
+## Common Android Paths
+
+- `/sdcard/Download/` - Downloads folder
+- `/sdcard/DCIM/Camera/` - Camera photos and videos
+- `/sdcard/Pictures/` - General pictures folder
+- `/sdcard/Screenshots/` - Screenshots (varies by device)
+- `/sdcard/WhatsApp/Media/` - WhatsApp media files
+- `/sdcard/Documents/` - Documents folder
+- `/sdcard/Music/` - Music files
+- `/sdcard/Movies/` - Video files
+
+## Making Scripts Executable
+
+First time setup:
+```bash
+chmod +x push.sh pull.sh adb-transfer.sh
+```
+
+## Examples
+
+### Backup all camera photos
+```bash
+./pull.sh /sdcard/DCIM/Camera/ ~/Pictures/android-backup/
+```
+
+### Push multiple PDFs to Downloads
+```bash
+./push.sh ~/Documents/*.pdf /sdcard/Download/
+```
+
+### Interactive file browser
+```bash
+./pull.sh
+# Then select option 1 to browse filesystem
+```
+
+### Quick backup using menu
+```bash
+./adb-transfer.sh
+# Select option 3 for quick actions
+# Select option 1 to backup all camera photos
+```
+
+## Troubleshooting
+
+### "No device connected" error
+1. Check USB cable connection
+2. Enable USB debugging: Settings → Developer options → USB debugging
+3. Accept the authorization prompt on your phone
+4. Try `adb devices` to verify connection
+
+### "Permission denied" errors
+- Some system directories require root access
+- Stick to `/sdcard/` paths for normal usage
+
+### Slow transfer speeds
+- Use USB 3.0 ports and cables when possible
+- Large files/directories take time - the scripts show progress
+
+## Tips
+
+1. **Use interactive mode** - It's easier and prevents typos
+2. **Backup regularly** - Use the quick actions menu for easy backups
+3. **Check free space** - Use device info option to see available storage
+4. **Organize transfers** - The scripts create timestamped folders for backups
+
+## Created with 💕 by Naomi & Hikari