# hamRemote

**Repository Path**: yzycoc/ham-remote

## Basic Information

- **Project Name**: hamRemote
- **Description**: ✨ HamRemote｜开源 Android 远程控制：ADB/USB 投屏触控 + APP 跨网，H.264 低延迟，自托管 Web/Windows/Android 客户端，MIT 可私有化，无云绑定
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# HamRemote

**Control Anywhere.** — Free & open-source cross-platform Android remote control

[中文](README.md) | [English](README.en.md)

HamRemote — open-source Android remote control (**ADB + APP**): screen, touch, device management; Web / Windows / Android clients; [MIT](LICENSE), self-hosted, no cloud lock-in or backdoor telemetry; LAN-ready, public setup in [Public deploy](docs/en/deploy.md).

<br>

[![License: MIT](https://img.shields.io/badge/License-MIT-3b82f6?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.12+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-009688?style=for-the-badge&logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Android-0078D4?style=for-the-badge&logo=windows&logoColor=white)](clients/)
[![Gitee](https://img.shields.io/badge/Gitee-ham--remote-C71D23?style=for-the-badge&logo=gitee&logoColor=white)](https://gitee.com/yzycoc/ham-remote)
[![Version](https://img.shields.io/badge/Release-0.0.1-6366f1?style=for-the-badge)](https://gitee.com/yzycoc/ham-remote)

<br>

[User guide](docs/en/guide.md) · [Public deploy](docs/en/deploy.md) · [Dev & build](docs/en/build.md) · [中文](docs/guide.md)

</div>

---

## Highlights

- **ADB + APP dual mode** — USB debug or ham Server over the network  
- **Low-latency H.264** — prefer native clients  
- **Auditable self-hosting** — your server, your keys  
- **Windows ready** — bundled ADB / scrcpy-server, auto `API_KEY`

## Preview

<p align="center">
  <img src="docs/img/web-亮色系.png" width="640" alt="Web" />
</p>
<p align="center">
  <img src="docs/img/ADB-控制页面.png" width="480" alt="Viewer" />
  &nbsp;
  <img src="docs/img/APP server-连接成功.jpg" width="180" alt="ham Server" />
</p>

<p align="center"><sub>USB debugging & APP setup → <a href="docs/en/guide.md">User guide</a></sub></p>

## Quick start (Windows)

1. Run **`HamRemote-Server.exe`**
2. Open http://127.0.0.1:8790/
3. Sign in with the printed **API_KEY**

Full steps → [User guide](docs/en/guide.md)

## Docs

| Doc | Description |
|-----|-------------|
| [User guide](docs/en/guide.md) | Install, USB debugging, APP agent, clients, screenshots |
| [Public deploy](docs/en/deploy.md) | Cloud server, FRP / Oray, Linux, security |
| [Dev & build](docs/en/build.md) | Tech stack, local env, run backend, package EXE / APK |
| [中文指南](docs/guide.md) | Chinese docs |

## Acknowledgments

- [Cursor](https://cursor.com/) — AI-assisted development of this project  
- [scrcpy](https://github.com/Genymobile/scrcpy) (Genymobile)  
- [Android Platform-Tools / ADB](https://developer.android.com/tools/adb) (Google)  
- [FastAPI](https://fastapi.tiangolo.com/) · [Uvicorn](https://www.uvicorn.org/)  
- [uiautomator2](https://github.com/openatx/uiautomator2)  
- [Electron](https://www.electronjs.org/) · [PyInstaller](https://pyinstaller.org/)  

---

<div align="center">

**HamRemote** — Control Anywhere.

Created by [Hamster](https://yzycoc.com) · [yzycoc@gmail.com](mailto:yzycoc@gmail.com)

[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
[![Gitee Star](https://gitee.com/yzycoc/ham-remote/badge/star.svg?theme=dark)](https://gitee.com/yzycoc/ham-remote/stargazers)

</div>