📱 Android PC Companion

Control your Android device from your desktop — mirror your screen, manage files, sideload apps, monitor battery, and more.

⬇️ Download the latest EXE · 🐛 Report an Issue

📖 About

Android PC Companion is a desktop app that bridges your PC and your Android phone. No bloat, no account, no root — it talks directly to your device over adb and scrcpy, and downloads those tools automatically on first launch. You never have to install them yourself.

Note: USB debugging must be enabled on your phone (Developer Options), or you can connect wirelessly via the built-in QR pairing.

🚀 Features

🏠 Dashboard

Live device summary — battery ring with estimated mAh, CPU load, memory usage, storage breakdown, and quick launchers into every section.

📁 File Explorer

Full-featured file manager for your device storage:

Multi-select files with checkboxes + batch download and upload with per-file progress
Drag-and-drop upload from your PC
Preview images, videos, text files, and PDFs inline
Breadcrumb navigation with clickable path segments and a back arrow
Clickable storage overview — jump straight to internal storage or SD card

📦 App Management

Filter chips (All / User / System / Disabled) + search
Sideload APKs from your PC
App diagnostics — APK size, declared permissions, clear-data, disable/enable, uninstall

🖥️ Screen Mirror

Real scrcpy mirroring with resolution / bitrate / FPS controls
Transport bar — volume, rotate, screenshot, screen record, long-press power — works over adb even when the mirror window is closed

📷 Multimedia Hub

Camera preview — view your phone's cameras (front/back/tele/wide) live, with sensor info
Capture photos and record video from any camera
Torch control with multi-tile flash support
Audio forwarding + media transport controls (play/pause/next/prev)
Now-playing display with track info
Use the phone as a PC webcam — via OBS Virtual Camera (Windows/macOS) or v4l2 loopback (Linux); see 🎥 Use Your Phone as a Webcam below

🔋 Hardware & Power

Fuller battery + device-spec readout — health, temperature, cycle count (where the kernel exposes it), voltage, and SoC details.

🛠️ Power Tools (ADB Console)

Quick-command buttons plus a free-text console that runs anything starting with adb or fastboot.

🔓 Bootloader & Backup

Unlock / reboot-to-bootloader
Fastboot partition flasher — pick a partition, pick a .img, confirm, flash (with confirmation for a reason — wrong image = brick)
Shared-storage backup flow

📡 Wireless Connection

QR pairing — the app renders a QR code locally, your phone scans it, done
Wi-Fi pairing with pairing code / port entry
Auto-connect — previously paired phones reconnect automatically
Multi-device switcher

⬇️ Download

Grab the latest installer from the Releases page:

👉 Download from GitHub Releases

Each release ships a Windows installer (Companion Setup x.x.x.exe). Just run it — adb, fastboot, and scrcpy are downloaded automatically on first launch.

The app version automatically matches the release tag (e.g. release v1.2.3 → exe version 1.2.3), so you always know what you're running.

📸 Screenshots

🏠 Dashboard — Dark, Light & Custom Themes

Dark Overview	Theme Picker	Light Mode	Storage & Memory

Battery station (47% charging), CPU cores at 99%, system memory 5.7/7.4 GB, storage breakdown, and the accent-color / dark-light-auto picker.

📁 File Explorer

Browse	Text Preview	Image Preview	Drag & Drop

Multi-select → batch download, breadcrumb navigation, SD card / internal storage, and inline previews for code, text, and images — drag files from Windows Explorer straight onto the device.

📦 App Management

518 packages with User / System / Bloatware / Frozen filters, search, APK sideload via drag-and-drop, and per-app diagnostics (size, permissions, freeze, uninstall).

🖥️ Screen Mirror (scrcpy)

Settings	Active Mirroring	YouTube Playback

Resolution / bitrate / FPS controls, docked control bar (power, volume, rotate, screenshot, record) and real device mirroring — works even when dragging the floating window around.

🛠️ Power Tools — ADB / Fastboot Console

One-click shortcuts (adb devices, dumpsys battery, etc.) plus a free-text shell for any adb / fastboot command.

📷 Multimedia Hub — Phone as Webcam

Standby	Live Camera Feed

Optics & stream parameters, sensor picker (Rear 12.5 MP / Front 16.2 MP), torch & mic toggles — standby → live camera bridge with the phone as a PC webcam.

🔋 Hardware & Power

Battery power station, real-time electrical & thermal telemetry (voltage, current, temp), SoC specs (Mediatek MT6833GP, 8 cores), RAM and storage details.

🔓 Bootloader & Backup

Fastboot Flasher	Backup & Binaries

Unlock suite with factory-reset warning, partition flasher (boot + custom .img), shared-storage backup and the adb / fastboot / scrcpy version panel (all READY).

📡 Connect Device — USB, Wireless & QR

USB Mode	Wireless Mode	QR Pairing	Switch Device

USB debugging guide + scan, Wi-Fi IP/port + 6-digit pairing code, QR code for Android 11+ wireless debugging, and the detected-devices switcher.

🪟 Installed on Windows

Companion appears under "Recently added" right after installing Companion Setup x.x.x.exe.

🎥 Use Your Phone as a Webcam

The Multimedia tab streams any phone camera to your PC. To make other apps (Zoom, Meet, Teams, Discord) see it as a webcam, bridge it through a virtual-camera driver. The Camera tab's bridge status tells you which route applies on your machine.

Windows / macOS — via OBS Studio

Windows has no built-in virtual camera, so the route is OBS Studio (free, signed driver — the app detects it and reports "OBS Virtual Camera available").

Connect your phone, open the Multimedia tab, pick a lens/resolution and press Start — a window titled Camera — <serial> appears. Keep it open.
Open OBS → Sources → + → Window Capture → select the Camera — <serial> window (crop/fit with right-click → Transform if needed).
In OBS → Controls (bottom-right) → Start Virtual Camera. First run may ask for admin to register the driver — one time only.
In Zoom/Meet/Teams/Discord, pick OBS Virtual Camera as the camera. If it doesn't appear, restart that app after step 3.

Keep OBS running while you use the camera elsewhere, and stop the stream in Companion when you're done.

Linux — direct via v4l2 loopback (no OBS needed)

sudo modprobe v4l2loopback exclusive_caps=1 card_label="Phone Camera"

Reopen the Camera tab — it will report v4l2 loopback ready with the device (e.g. /dev/video2). Start the stream and pick Phone Camera as the camera in any app. (Needs a scrcpy build with --v4l2-sink — distro packages have it; the tab warns you otherwise.)

Mic: the camera tab's mic toggle forwards the phone mic into the stream audio (heard on PC speakers). The OBS route above carries video — for calls, pair it with your usual microphone, or use OBS's audio monitoring to route it.

🧰 Tech Stack

Built with:

	Technology	Purpose
	Electron	Desktop app shell, frameless window with acrylic/vibrancy
	Node.js	Main-process logic, IPC, tool orchestration
	ADB / Fastboot	Device communication, file transfer, shell commands
	scrcpy	Screen mirroring + camera feed
	Vanilla JS	Renderer — no frontend framework
	HTML + CSS	UI layout, custom window chrome
	jsQR	QR code decoding (pairing flow)
	extract-zip	Tool extraction after download

Zero adb/scrcpy knowledge required — the app auto-downloads platform-tools from Google and scrcpy from its GitHub releases into its own user-data folder, and uses those copies from then on.

🚦 Getting Started (Development)

Requirements: Node.js 18+, a real desktop session (not headless), and for USB workflows, physical USB access to the phone.

# Clone
git clone https://github.com/jackhallloween21/Android-PC-Companion-App.git
cd Android-PC-Companion-App

# Install dependencies
npm install

# Run in dev mode
npm start

# Run the test suite
npm test

# Build the Windows installer
npm run dist

📂 Project Structure

Android-PC-Companion-App/
│
├── main.js                  # Electron main process — window, IPC handlers,
│                            #   adb/fastboot/scrcpy orchestration
├── preload.js               # Secure bridge between main & renderer (contextIsolation)
│
├── src/                     # Pure logic modules (no DOM, testable)
│   ├── apps.js              #   App inventory from pm list packages / dumpsys
│   ├── autoconnect.js       #   Remember wirelessly-paired devices
│   ├── camera.js            #   Camera capability discovery, torch, launch args
│   ├── dock.js              #   Docked-mirror window geometry
│   ├── downloader.js        #   Auto-download adb/fastboot/scrcpy
│   ├── keys.js              #   Device key & status-bar commands over adb
│   ├── media.js             #   Now-playing parsing from dumpsys media_session
│   ├── pairing.js           #   QR payload generation for wireless pairing
│   ├── perf.js              #   CPU/RAM telemetry from /proc
│   ├── power.js             #   Battery/power parsing from kernel power-supply class
│   ├── qrencode.js          #   Hand-rolled QR encoder (byte mode, v1-10)
│   ├── scrcpy.js            #   scrcpy version-aware flag detection & arg building
│   ├── storage.js           #   Storage breakdown (dumpsys diskstats + df)
│   ├── theme.js             #   Accent colors & light/dark/auto themes
│   ├── winmove.js           #   Move/resize the foreign scrcpy window (Windows)
│   └── wireless.js          #   Wireless debugging helpers (pair vs connect ports)
│
├── renderer/                # UI layer
│   ├── index.html           #   App shell — titlebar, sidebar, views, modals
│   ├── renderer.js          #   Renderer logic — state, views, event wiring
│   ├── controlbar.html      #   Mirror transport control bar
│   ├── controlbar.js        #   Transport bar logic
│   └── styles.css           #   Full styling — glass cards, dark theme
│
├── test/                    # Node test-runner suite (one file per src module)
├── tools/                   # Dev utilities (icon builder)
├── assets/                  # Bundled resources
│
└── .github/workflows/
    └── build.yml            # CI: builds the exe on release, auto-bumps version
                             #   from the release tag, attaches it to the release

⚙️ How It Works

Everything the app does is a real adb / fastboot / scrcpy invocation — nothing is mocked. The main process shells out via child_process.execFile, parses output with the pure modules in src/, and exposes it to the renderer over typed IPC channels.

Auto-downloaded tools — on first launch the app checks for adb/fastboot/scrcpy on your PATH. Missing ones are downloaded (platform-tools from dl.google.com, scrcpy from GitHub releases) into app.getPath('userData')/bin and reused forever. The Binaries & Drivers panel in the sidebar shows resolved paths, versions, and a re-verify button.

Wireless QR pairing — the PC displays a QR code rendered by the app's own encoder (src/qrencode.js, byte-mode, versions 1–10, round-trip tested); the phone scans it with Android's "Pair device with QR code" screen. The phone then advertises over mDNS (_adb-tls-pairing._tcp), the app runs adb pair against it, then connects on the separate _adb-tls-connect._tcp port. A manual pairing-code form is the fallback when adb's mDNS backend isn't running (common on Windows).

Window chrome — frameless with a custom titlebar, using native OS effects: vibrancy on macOS, backgroundMaterial: 'acrylic' on Windows 11 22H2+, opaque on Linux for compositor safety.

⚠️ Known Approximations

Honest engineering notes — real functionality, best-effort data sources:

Storage breakdown is per-folder du -sh (DCIM/Pictures/etc.), not a true partition split — Android doesn't expose that without root
Battery cycle count reads /sys/class/power_supply/battery/cycle_count, missing on some kernels → shows "N/A", not a fake number
Console command parsing splits on whitespace — quoted args with spaces won't parse; it's for one-liners, not a full shell
Fastboot flashing will brick a device given the wrong image — that's why the confirmation dialog exists
Camera feed displays in-app, with a bridge-status row that routes it to other apps: OBS Virtual Camera on Windows/macOS, direct v4l2 loopback on Linux — see 🎥 Use Your Phone as a Webcam

🤝 Contributing

Fork the repo
Create your branch (git checkout -b feature/amazing)
Commit changes (git commit -m 'Add amazing feature')
Push (git push origin feature/amazing)
Open a Pull Request

Run npm test before submitting — the test suite covers every src/ module.

📄 License

Made with ❤️ and lots of adb shell

⭐ Star the repo if you find it useful!

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
Screenshots		Screenshots
assets		assets
renderer		renderer
src		src
test		test
tools		tools
.gitignore		.gitignore
README.md		README.md
index.html		index.html
main.js		main.js
package-lock.json		package-lock.json
package.json		package.json
preload.js		preload.js
r8.jar		r8.jar
renderer.js		renderer.js
smartphone.ico		smartphone.ico
smartphone.png		smartphone.png
styles.css		styles.css

Latest commit

History

Folders and files

Repository files navigation

📱 Android PC Companion

📖 About

🚀 Features

🏠 Dashboard

📁 File Explorer

📦 App Management

🖥️ Screen Mirror

📷 Multimedia Hub

🔋 Hardware & Power

🛠️ Power Tools (ADB Console)

🔓 Bootloader & Backup

📡 Wireless Connection

⬇️ Download

📸 Screenshots

🏠 Dashboard — Dark, Light & Custom Themes

📁 File Explorer

📦 App Management

🖥️ Screen Mirror (scrcpy)

🛠️ Power Tools — ADB / Fastboot Console

📷 Multimedia Hub — Phone as Webcam

🔋 Hardware & Power

🔓 Bootloader & Backup

📡 Connect Device — USB, Wireless & QR

🪟 Installed on Windows

🎥 Use Your Phone as a Webcam

Windows / macOS — via OBS Studio

Linux — direct via v4l2 loopback (no OBS needed)

🧰 Tech Stack

🚦 Getting Started (Development)

📂 Project Structure

⚙️ How It Works

⚠️ Known Approximations

🤝 Contributing

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages