Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .eslintrc.json
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@
"no-console": [
"error",
{
"allow": ["warn", "error"]
"allow": ["warn", "error", "info"]
}
],
"no-use-before-define": ["off"],
Expand Down
265 changes: 107 additions & 158 deletions CHANGELOG.md

Large diffs are not rendered by default.

79 changes: 79 additions & 0 deletions adb-proxy/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# ADB Proxy - Portable Executable

This ADB proxy creates portable executables that don't require Node.js or ADB to be installed locally.

## For End Users

### Quick Start

1. **Download** the appropriate build for your platform from releases
2. **Extract** the archive to any folder
3. **Connect** your Android device with USB debugging enabled
4. **Double-click** the startup script:
- **Windows**: `start.bat`
- **macOS**: `start.command`
- **Linux**: `start.sh`

The proxy will start on `http://localhost:3080`

## For Developers

### Building Executables

```bash
# Install dependencies
yarn install

# Build for specific platforms
yarn build-windows # Creates dist/windows/
yarn build-linux # Creates dist/linux/
yarn build-macos # Creates dist/macos/

# Build for all platforms
yarn build-all
```

### How It Works

The build process uses [@yao-pkg/pkg](https://github.com/yao-pkg/pkg) (maintained fork) to create standalone executables:

1. **pkg** bundles the Node.js application into a single executable
2. **build-platforms.js** downloads platform-specific ADB binaries
3. **Everything** is packaged together with startup scripts

### Distribution

Each platform build creates a `dist/{platform}/` directory with:

```
📁 dist/windows/ 📁 dist/macos/ 📁 dist/linux/
├── 🟢 start.bat ├── 🟢 start.command ├── 🟢 start.sh
├── 🔧 adb.exe ├── 🔧 adb ├── 🔧 adb
├── ⚙️ adb-proxy.exe ├── ⚙️ adb-proxy ├── ⚙️ adb-proxy
├── 📄 adbwinapi.dll ├── 📄 README.txt ├── 📄 README.txt
├── 📄 adbwinusbapi.dll └── 📚 USER-GUIDE.md └── 📚 USER-GUIDE.md
├── 📄 README.txt
└── 📚 USER-GUIDE.md
```

### File Sizes

- **Windows**: ~52MB
- **macOS**: ~75MB
- **Linux**: ~63MB

## Development

### Project Structure

```
adb-proxy/
├── adb-proxy.js # Main server application
├── capture-utterances.js # TalkBack capture logic
├── build-platforms.js # Build system for all platforms
├── package.json # Dependencies and build scripts
└── dist/ # Built executables (generated)
├── windows/
├── linux/
└── macos/
```
Loading
Loading