Skip to content

About

Open-source Android screen mirroring & DLNA casting over local Wi‑Fi — offline, no ads, no account, encrypted. Phone → TV, Android TV receiver, DLNA push, iPhone compatible (unofficial). 局域网投屏

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

LAN Screen Cast — open-source Android screen mirroring & DLNA casting over local Wi‑Fi

English | 简体中文

CI License: GPL-3.0 Platform: Android 10+ Offline No ads

LAN Screen Cast (Chinese name: 局域投屏) is a free, open-source (GPL-3.0) Android app for screen mirroring and casting over your local network. Mirror an Android phone or tablet to an Android TV, TV box, tablet or another phone; push videos, photos and music to any DLNA / UPnP TV; and receive casts from video apps and iPhone/iPad. It works offline on the same Wi‑Fi: no internet, no cloud, no ads, no account, no data collection.

One APK works as both sender and receiver: phones and tablets send by default, TVs receive by default.

Status: pre-release. The features below are implemented and covered by unit tests and emulator runs, but none of them has been verified on real devices yet. Feature status and the on-device test list are in docs/dev/开发进度.md (Chinese).

Screenshots

TV receiver waiting for a cast, with QR code and cast code TV showing the mirrored phone screen, letterboxed

Phone: discovered TVs with Mirror and Push actions Phone: mirroring in Game mode with live latency Phone: DLNA push remote with playlist, seek and volume Elder mode home with large buttons Settings in dark mode

TV receiver · TV mirroring a phone · device list · Game mode · DLNA push remote · Elder mode · dark theme (captured on emulators)

Features

Screen mirroring

  • Low-latency mirroring over WebRTC (H.264), with the phone's playback audio. The microphone is never opened.
  • Encryption is always on: mutual TLS 1.3 with certificate pinning. A 4-digit PIN is needed only on the first connection; after that the devices trust each other.
  • Several ways to connect: automatic discovery (mDNS/SSDP), QR code, 8-digit cast code, or manual IP.
  • Quality presets: Smooth, Balanced, High and Game (720p60 with a minimal jitter buffer). Presets can be switched during a session.
  • Automatic reconnection, a quick-settings tile, and local cast reports.

DLNA

  • Receiver: choose this device from the "cast" button in video apps.
  • Push to TV: send local videos, photos, music or a video URL from your phone to a TV's built-in DLNA receiver, then control playback from the phone or the lock screen. Videos the TV can't play are converted first.
  • System share sheet: share files or links from any app straight to a TV. Recently used TVs also appear directly in the share sheet.

Compatible with Apple devices (unofficial)

  • iPhone and iPad can connect using the system's Screen Mirroring: screen mirroring, audio, and video URLs. It is off by default and built on UxPlay.

More

  • Elder mode: large text, large buttons, and one tap to cast to a TV that a family member has set up.
  • Reverse control (optional): the receiver can operate the sending phone. It uses an accessibility service and requires your confirmation for every session.
  • TV-friendly receiver UI: remote-control navigation and Leanback launcher support.
  • Share the installer: serve the receiver APK to a TV over the local network.
  • Diagnostics stay local: network diagnostics and diagnostic logs are kept only on the device.

Privacy

  • No analytics, ads, crash reporting or Google Play services.
  • WebRTC uses host candidates only; no STUN or TURN servers.
  • The app never connects to the internet. There are two exceptions, both started by you: a URL you push to a TV, and a video URL sent by an Apple device. In both cases the TV or player fetches the URL directly; the app itself does not.

See docs/PRIVACY.md.

FAQ

How do I mirror my Android phone to a TV without internet? Install LAN Screen Cast on both devices and connect them to the same Wi‑Fi. Open it on the TV, which becomes the receiver. Then pick the TV on the phone. Everything stays on your local network.

Can I cast to a TV that doesn't have this app? Yes, for media. Most smart TVs and TV boxes have a built-in DLNA/UPnP renderer, and the app can push videos, photos, music and video URLs to them. Full screen mirroring needs the app on the receiving device.

Can an iPhone or iPad cast to an Android TV with this app? Yes. Turn on "Compatible with Apple devices (unofficial)" in the receiver's settings. The iPhone or iPad can then use its built-in Screen Mirroring. Under the hood it is an unofficial, open-source implementation of an AirPlay-compatible mirroring receiver, based on UxPlay. It is not endorsed by Apple.

Does it work as a DLNA receiver for video apps? Yes. The receiver advertises itself as a DLNA media renderer, so video apps with a "cast" or "TV" button can find it.

Is it secure? Mirroring is always encrypted with mutual TLS 1.3 and certificate pinning, and the first connection is confirmed with a PIN. DLNA itself is unencrypted, as the protocol defines, so the receiver asks before accepting a new DLNA sender.

How low is the latency? The Game preset targets about 100 ms end to end on a good Wi‑Fi network. Real-device measurements are still pending.

Does it need Google Play services or root? No to both. It also has no analytics and no crash reporting.

Requirements

  • Android 10 (API 29) or later, on phones, tablets and Android TV.
  • Sender and receiver must be on the same local network.
  • UI languages: English (default) and Simplified Chinese, following the system language. On Android 13+ you can also pick the app language in system settings.

Building

You need the Android SDK (compileSdk 37). Gradle provisions the JDK through its toolchain support. The default build includes the Apple-compatible receiver, which also requires NDK 27.0.12077973, CMake 3.22.1 and the git submodules.

git clone https://github.com/binbenc/Android-LANScreenCast.git && cd Android-LANScreenCast
git submodule update --init --depth 1 protocol-impl/airplay/src/main/cpp/third_party

./gradlew assembleDebug          # debug APKs per ABI + universal (app/build/outputs/apk/debug)
./gradlew assembleRelease        # R8-optimized release APKs (unsigned)
./gradlew test                   # JVM unit tests
./gradlew lint

./gradlew assembleDebug -Pwsc.airplay=false   # without the Apple-compatible receiver (no submodules or NDK needed)

The first native build cross-compiles OpenSSL and FFmpeg for each ABI, which takes about 2–3 minutes. Later builds skip this step.

Project layout

app/              entry point, navigation, onboarding
core/             protocol, security (TLS/SPAKE2), discovery, signaling, WebRTC, data, UI theme
feature/          sender, receiver, settings, reverse control
protocol-impl/    DLNA renderer and controller, UPnP client, Apple-compatible receiver (JNI)
protocol/         wire protocol spec (PROTOCOL.md) and shared test vectors
docs/             PRD, technical design, interaction design, progress (Chinese)

Documentation

All documents are in Chinese.

Contributing

Issues and pull requests are welcome. Please follow these project rules:

  • No new network access.
  • New dependencies must be GPL-3.0 compatible.
  • No analytics or Google Play services.
  • Run ./gradlew test lint before submitting.

License

GPL-3.0.

Third-party components keep their own licenses:

  • libwebrtc: BSD-3-Clause
  • UxPlay: GPL-3.0
  • libplist: LGPL-2.1+
  • OpenSSL 3.5: Apache-2.0
  • FFmpeg (ALAC decoder only): LGPL-2.1+

Details are in protocol-impl/airplay/src/main/cpp/third_party/README.md and core/rtc/THIRD_PARTY.md.

This project is not affiliated with or endorsed by Apple Inc. AirPlay, iPhone and iPad are trademarks of Apple Inc. All trademarks belong to their respective owners.

About

Open-source Android screen mirroring & DLNA casting over local Wi‑Fi — offline, no ads, no account, encrypted. Phone → TV, Android TV receiver, DLNA push, iPhone compatible (unofficial). 局域网投屏

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages