ArchiveMad

ArchiveMad is an Electron desktop app for browsing Android device storage over ADB and copying media, documents, and folders to your computer.

The project currently includes two app surfaces:

• ArchiveMad v1: the original file explorer experience with quick access locations, preview support, copy actions, delete actions, and storage information.
• ArchiveMad v2: a newer sync-focused console with device detection, file filtering, thumbnails, target folder selection, sync planning, skipped/changed file detection, progress reporting, and English/Turkish language support.

Requirements

• Node.js and npm
• Android Debug Bridge (adb)
• An Android device with USB debugging enabled

ADB can be installed through Android Studio or with Homebrew on macOS:

brew install android-platform-tools

The app checks common ADB locations, including:

• /opt/homebrew/bin/adb
• /usr/local/bin/adb
• ~/Library/Android/sdk/platform-tools/adb
• adb from your PATH

Install

npm install

Run

Start the original explorer:

npm start

Start the v2 sync console:

npm run v2

Basic Usage

1. Connect your Android device with USB.
2. Enable USB debugging on the device.
3. Accept the Android debugging authorization prompt if it appears.
4. Open ArchiveMad.
5. Choose a location such as Internal Storage, Camera, Pictures, Downloads, Documents, or Videos.
6. Select files or folders.
7. Choose a local target folder.
8. In v2, click Plan to review what will be copied or skipped, then click Transfer.

v1 Overview

The v1 app is a general Android file explorer. It can:

• List connected Android devices.
• Browse /sdcard and common media folders.
• Preview supported images and videos.
• Pull selected files to a local folder.
• Delete files or folders from the device.
• Show basic device storage usage.

Use it when you want a direct file-manager style workflow.

v2 Overview

The v2 app is focused on safer selective backup and sync. It can:

• Detect whether ADB is installed and show setup help when it is missing.
• Browse Android storage with quick locations and type filters.
• Search and sort visible files.
• Preview images and videos.
• Select files or entire folders.
• Build a sync plan before copying.
• Skip files that already exist locally with the same size.
• Mark changed files for transfer.
• Preserve folder structure under the selected target directory.
• Show transfer progress and allow cancellation.
• Switch between English and Turkish.

Use it when you want to review a backup plan before copying data.

Notes

• ArchiveMad uses ADB locally; it does not require a cloud account.
• Transfer behavior depends on Android file permissions and ADB access.
• Some protected app directories may not be readable without additional Android permissions.
• The project is currently Electron-based and uses plain JavaScript, HTML, and CSS.

Project Structure

src/        Original ArchiveMad app
srv_v2/     ArchiveMad v2 sync console

License

ArchiveMad is released under the MIT License. You can use, copy, modify, distribute, sublicense, and sell copies of the software under the terms of the license.