A sleek macOS desktop application for browsing Android device files via ADB (Android Debug Bridge).

🌐 Visit DroidDock Website | 📦 Download Latest Release

• 📱 Device Detection: Automatically detects connected Android devices
• 📂 File Browsing: Navigate through your Android device's file system with an intuitive interface
• 👁️ Multiple View Modes: Choose between Table, Grid, List, or Column (Miller) view with keyboard shortcuts
• 🔍 File Search: Search for files by name with case-insensitive matching and recursive search
• 🗑️ File Deletion: Delete files and folders with confirmation dialogs and safety checks
• 📥 File Download: Download files from device to Mac with save dialog
• 📤 File Upload: Upload files from Mac to device via floating action button
• ✅ Multi-Select: Select multiple files with checkboxes, Ctrl/Cmd+click, and Shift+click range selection
• 🖼️ Thumbnails: Automatic thumbnail generation for images and videos with lazy loading
• 🏠 Smart Breadcrumbs: Clean navigation with "Internal storage" labels and arrow separators
• 👁️ Hidden Files Toggle: Show or hide dot files with a single click
• 📊 File Information: View file permissions, sizes, and modification dates
• 💾 Storage Info: Real-time storage usage display in VSCode-style status bar
• 🎯 Contextual Actions: File actions (download/delete) appear in a slide-up bar when files are selected
• ⌨️ Keyboard Shortcuts: Full keyboard navigation with arrow keys, view switching, and file operations
• 🎨 Dark Mode Support: Beautiful dark mode with muted, cohesive color palette
• 🛠️ Smart ADB Detection: Automatically finds ADB in common installation locations
• ⚙️ Custom ADB Path: Set a custom ADB path if it's not automatically detected

DroidDock with grid view showing image thumbnails, contextual action bar, and floating upload button

Before running DroidDock, you need to have:

Install via Homebrew (Recommended):

brew install android-platform-tools

Or download manually:

• Download from: Android Platform Tools

DroidDock automatically checks these common ADB locations:

• /opt/homebrew/bin/adb (Apple Silicon Homebrew)
• /usr/local/bin/adb (Intel Mac Homebrew)
• /opt/local/bin/adb (MacPorts)
• ~/Library/Android/sdk/platform-tools/adb (Android Studio)

• Version: 20.19+ or 22.12+
• Download from: https://nodejs.org/

• Install from: https://rustup.rs/

1. Download: Get the latest .dmg file from the Releases page or DroidDock website.

2. Install: Open the DMG and drag DroidDock to your Applications folder.

3. Launch: Since the app is currently unsigned, you need to:

   • Right-click the app and select "Open"
   • Click "Open" in the security dialog
   • (Future releases will be code-signed to remove this step)

4. Auto-Updates: DroidDock will automatically check for updates on launch and notify you when new versions are available.

1. Clone the repository:

   git clone https://github.com/rajivm1991/DroidDock.git
   cd droiddock

2. Install dependencies:

   npm install

3. Run in development mode:

   npm run tauri dev

4. Or build for production:

   npm run tauri build

   The compiled app will be in src-tauri/target/release/bundle/.

Enable USB debugging on your Android device:

1. Go to Settings → About Phone
2. Tap Build Number 7 times to enable Developer Options
3. Go to Settings → Developer Options
4. Enable USB Debugging
5. Connect your device via USB

adb devices

You should see your device listed.

• The app will automatically detect your device
• Select it from the dropdown menu
• Browse files starting from /storage/emulated/0 (main storage)

• Single-click folder names to open them
• Use breadcrumb navigation or the ↑ Up button to go back
• Switch Views: Use view toggle buttons or keyboard shortcuts (Cmd+1/2/3/4) to switch between Table, Grid, List, or Column view
• Toggle Show Hidden Files in settings to view dot files
• Toggle Show Thumbnails in settings to enable/disable image and video previews
• Click Refresh to reload the device list
• Upload Files: Click the floating action button (bottom-right) to upload files to current directory
• File Actions: Select files to reveal the contextual action bar with Download and Delete options

• Type in the search bar to find files by name (case-insensitive)
• Check All subdirectories to search recursively through all folders
• Click Search or press Enter to execute the search
• Search results show full file paths
• Click Clear to exit search mode

• Click checkbox or click row to select files
• Ctrl/Cmd + Click: Toggle individual files for multi-select
• Shift + Click: Select a range of files between two clicks
• Ctrl/Cmd + A: Select all visible files
• Press Delete or Backspace key to delete selected files
• Confirm deletion in the dialog that appears
• The app prevents deletion of critical system directories

• Frontend: React + TypeScript + Vite
• Backend: Rust + Tauri
• Styling: Custom CSS with dark mode support

droiddock/
├── src/                 # React frontend
│   ├── App.tsx         # Main application component
│   ├── App.css         # Styles
│   └── main.tsx        # Entry point
├── src-tauri/          # Rust backend
│   ├── src/
│   │   ├── lib.rs      # ADB commands and core logic
│   │   └── main.rs     # Application entry point
│   ├── Cargo.toml      # Rust dependencies
│   └── tauri.conf.json # Tauri configuration
└── package.json        # Node.js dependencies

The app implements these Tauri commands:

• check_adb() - Verify ADB installation
• get_devices() - List all connected devices
• list_files(device_id, path) - List files in a directory
• delete_file(device_id, file_path, is_directory) - Delete files and folders with safety checks
• search_files(device_id, search_path, pattern, recursive) - Search for files by name
• get_thumbnail(device_id, file_path, extension, file_size) - Generate thumbnails for images and videos
• detect_storage_path(device_id) - Automatically detect the primary storage path
• get_storage_info(device_id, path) - Get storage usage statistics for device
• download_file(device_id, device_path, local_path) - Download file from device to Mac
• upload_file(device_id, local_path, device_path) - Upload file from Mac to device
• set_adb_path(path) - Set custom ADB path
• get_current_adb_path() - Get current ADB path

DroidDock supports these keyboard shortcuts for faster navigation and file management:

If the app can't find ADB:

1. Install ADB via Homebrew:

   brew install android-platform-tools

2. Or set a custom path:

   • The app will show a setup screen
   • Enter the full path to your ADB executable (e.g., /opt/homebrew/bin/adb)
   • Click "Set Path"

• Ensure USB debugging is enabled on your device
• Check if device is recognized: adb devices
• Try clicking the "Refresh" button in the app
• You may need to accept the debugging authorization prompt on your device

• Some system directories require root access
• Try browsing user-accessible directories like /storage/emulated/0 or /sdcard

• Single-click on the folder name (the blue text) to open it
• Wait for the loading indicator to finish
• Note: Clicking elsewhere on the row selects the folder instead of opening it

npm run tauri dev

Changes to React files will hot-reload automatically. Changes to Rust files will trigger recompilation.

npm run tauri build

# Frontend tests
npm test

# Rust tests
cd src-tauri && cargo test

To preview the website (docs/index.html) locally:

# Using Python (built-in on macOS)
cd docs && python3 -m http.server 8080

# Or using npx
cd docs && npx serve

Then open http://localhost:8080 in your browser.

To stop the server: Press Ctrl+C or run pkill -f "python3 -m http.server 8080"

DroidDock uses an automated release workflow:

1. Prepare the release (updates versions and creates git tag):

   npm run release:prepare 0.2.0

2. Push the changes and tag:

   git push origin <branch-name>
   git push origin v0.2.0

3. Automated build: GitHub Actions will:

   • Build a universal macOS binary (Apple Silicon + Intel)
   • Create a DMG installer
   • Generate updater manifest with signature
   • Create a GitHub Release with the DMG attached

4. Auto-update: Users with existing installations will be notified of the update.

• Workflow file: .github/workflows/release.yml
• Version script: scripts/release-prepare.js
• Updater config: src-tauri/tauri.conf.json (plugins.updater)
• Signing: Uses Tauri updater signatures (stored in GitHub Secrets)

To remove macOS security warnings, code signing requires:

• Apple Developer Program membership ($99/year)
• Code signing certificate
• Notarization workflow

Potential features for future releases:

• 📷 File Preview - Preview images and text files in-app
• 💾 Drag & Drop - Drag files to/from the app
• 📱 Multiple Devices - View multiple devices simultaneously
• ⏱️ File Sync - Sync files between Mac and Android
• 📊 Sortable Columns - Sort files by name, size, date, etc.
• 📈 Transfer Progress - Show progress bars for file transfers
• 📁 Folder Download/Upload - Support for transferring entire directories

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

MIT License - see LICENSE file for details.

• Built with Tauri - A framework for building desktop applications with web technologies
• Icons from system emoji set
• Inspired by the need for a simple, native Android file browser on macOS

If you encounter any issues or have questions:

• Open an issue on GitHub Issues
• Check the Troubleshooting section above

Note: DroidDock requires USB debugging to be enabled on your Android device. This app does not collect or transmit any personal data.