APK-Cast

Serve Android builds to mobile instantly over LAN.

APK-Cast is a utility to host Android Studio, Flutter, and React Native APK builds locally. It allows you to test application builds on real mobile devices without USB cables by serving them over your local network IP.

Use Case: Developers need to test APKs on physical devices frequently. Instead of manual transfers or cloud uploads, APK-Cast creates a local web server that connected mobile devices can access to download and install builds in seconds.

---

# Index

• Features
• Installation and Download
• Contribute
• Requirements
• Troubleshooting
• License & Legal
• Privacy Policy
• Links & Contact

---

# Features

• LAN Hosting: Serve APKs directly to any device on your Wi-Fi/Local network.
• Multi APK Support: Automatically organize hierarchical builds (Alpha, Beta, Debug, Release).
• Auto-Refresh: Mobile interface updates instantly when new builds are added.
• QR Integration: Scan a console-generated QR code for instant mobile access.
• Path Manager: Built-in tool to run APK-Cast from any folder or terminal.

---

# How to install

Download: Get the latest release here

1. Download & Extract: Unzip the latest release into a permanent folder on your PC.
2. Set Environment Path:
   • Open Set-Env-Path.exe from the extracted folder.
   • Select "Add to PATH" (Option 1 for User, Option 2 for System/Admin).
   • This allows you to launch the tool from anywhere.
3. How to Start:
   • Open your project folder (where your APKs are) in File Explorer.
   • Type apkcast in the address bar of File Explorer in your Project Folder and press Enter.
   • Alternatively: Open a terminal in your project folder and type apkcast.
4. Select Option:
   • 1. Search Multi APK Folder: (Recommended) Best for projects with subfolders like /debug and /release.
   • 2. Enter a path manually: Type or paste a specific directory.
   • 3. Search single APK: Find a specific file to serve its containing folder.
5. Connect: Scan the QR code shown in the terminal with your phone.

CAUTION: If connection fails, ensure your phone and PC are on the same Wi-Fi. You must disable Cloudflare WARP, VPNs, or Private DNS settings on both devices for the local IP to be reachable.

---

# How to contribute

We welcome contributions! Follow these steps to set up your local development environment:

1. Clone the Repo: https://github.com/SubhamSathua/apk-cast.git
2. Environment: Create a virtual environment and install dependencies:

   python -m venv .venv
   .venv\Scripts\activate
   pip install qrcode pillow pyinstaller

3. Build Binary: To generate the production executables with icons and metadata:

   python build_exe.py

---

# Requirements

• OS: Windows 10 or 11 (64-bit).
• Network: Both devices must be on the same Local Area Network (LAN) or Wi-Fi.
• Permissions: Admin rights are required for "System Path" modifications.
• Python: Python 3.10+ (only if running from source).

---

# Troubleshooting

• Firewall: Ensure Windows Firewall allows apkcast.exe to communicate on the network.
• Port Conflict: If Port 9000 is used, the server might fail to bind (check other running services).
• No APKs Found: Ensure you are running the tool in a directory that actually contains .apk files.

---

# License & Legal

This project is licensed under the Apache License 2.0.

Liability Protection: The author provides this software "as is" without warranties. By using this software, you agree that the author is not liable for any damages, data loss, or system issues resulting from its use.

Modifications: If you modify and distribute this software, you must:

1. Retain all original copyright notices.
2. Include a copy of the Apache License.
3. Protect the original author from any liability claims arising from your modified version.

---

# Privacy Policy

• 100% Local: All APK processing and serving happens strictly on your local network.
• No Internet Required: The tool does not send any data to external servers or the cloud.
• No Tracking: Zero telemetry, zero analytics, and zero background tracking services.

---

# Links

• Report an Issue - If you find a bug, please report it here.
• Security Policy - For reporting security vulnerabilities.
• Apache 2.0 License

---

# Contact

• Author: Subham Kumar Sathua
• GitHub: @SubhamSathua)
• Email: hyper.devstudio@protonmail.com

---

Copyright © 2026 Subham Kumar Sathua. Licensed under the Apache License 2.0.