addozhang/leancast

选用指南

AI 根据 README 整理 · 2026/10/28 14:26:19

适用场景

适用于 Android TV 设备，通过 DLNA/UPnP 接收来自手机视频应用的投屏内容，实现无广告、无账户、无云端的本地播放。

查看 README 依据

# LeanCast English | [简体中文](README.zh-CN.md) <p align="center"> <img src="docs/screenshots/main-en.png" width="49%" alt="LeanCast TV dashboard" /> <img src="docs/screenshots/player-osd-en.png" width="49%" alt="LeanCast playback OSD" /> </p> A minimal, ad-free **DLNA/UPnP cast receiver** for Android TV. Open any video app with a cast button (Bilibili, iQiyi, Tencent Video, Youku, Quark, …), pick this receiver, and the video plays fullscreen with hardware decoding — no ads, no accounts, no cloud. ``` Phone app --SSDP--> discovers Phone app --SOAP SetAVTransportURI--> LeanCast

Optional: enable **Start on boot** in the app. ## Supported devices LeanCast is a pure-Kotlin APK with **no native libraries** and `minSdk 21` (Android 5.0, 2014), so a single artifact covers `armeabi-v7a`, `arm64-v8a`, `x86` and `x86_64`. Decoding uses each device's platform `MediaCodec`, so codec coverage follows the device: H.264 everywhere, HEVC/4K on 2016+ TVs, AV1 only on newer boxes. | Tier | Devices | Notes | | :--- | :--- | :--- | | ✅ Verified | Amazon Fire TV / Fire TV Stick (Fire OS 6/7) | Primary test device: Fire OS 7.7, 32-bit MTK SoC |

目标用户

面向 Android TV 用户，尤其是希望摆脱广告和云端依赖的隐私敏感用户，同时也为开发者提供可测试的 UPnP 实现参考。

查看 README 依据

# LeanCast English | [简体中文](README.zh-CN.md) <p align="center"> <img src="docs/screenshots/main-en.png" width="49%" alt="LeanCast TV dashboard" /> <img src="docs/screenshots/player-osd-en.png" width="49%" alt="LeanCast playback OSD" /> </p> A minimal, ad-free **DLNA/UPnP cast receiver** for Android TV. Open any video app with a cast button (Bilibili, iQiyi, Tencent Video, Youku, Quark, …), pick this receiver, and the video plays fullscreen with hardware decoding — no ads, no accounts, no cloud. ``` Phone app --SSDP--> discovers Phone app --SOAP SetAVTransportURI--> LeanCast

Optional: enable **Start on boot** in the app. ## Supported devices LeanCast is a pure-Kotlin APK with **no native libraries** and `minSdk 21` (Android 5.0, 2014), so a single artifact covers `armeabi-v7a`, `arm64-v8a`, `x86` and `x86_64`. Decoding uses each device's platform `MediaCodec`, so codec coverage follows the device: H.264 everywhere, HEVC/4K on 2016+ TVs, AV1 only on newer boxes. | Tier | Devices | Notes | | :--- | :--- | :--- | | ✅ Verified | Amazon Fire TV / Fire TV Stick (Fire OS 6/7) | Primary test device: Fire OS 7.7, 32-bit MTK SoC |

使用方式

通过 ADB 安装 APK 并启动应用，应用作为 DLNA 接收器出现在投屏设备列表中，用户可从视频应用选择投屏。

查看 README 依据

- Tested on an Amazon Fire TV (Fire OS 7 / Android 9, 32-bit MTK SoC) with `minSdk 21` / `targetSdk 28`. ## Build Requirements: JDK 17+, Android SDK (platform 34). Then: ```bash ./gradlew assembleDebug # app/build/outputs/apk/debug/app-debug.apk ``` ## Install & use ```bash adb connect <TV-IP>:5555 adb install -r app/build/outputs/apk/debug/app-debug.apk adb shell am start -n io.leancast/io.leancast.app.MainActivity ``` Launch the app once to start the receiver service; it then appears in every DLNA sender's device list under the receiver name (rename it in the app).

部署要求

需要 Android 5.0 及以上版本的设备，支持 armeabi-v7a、arm64-v8a、x86 和 x86_64 架构，不包含原生库。

查看 README 依据

Optional: enable **Start on boot** in the app. ## Supported devices LeanCast is a pure-Kotlin APK with **no native libraries** and `minSdk 21` (Android 5.0, 2014), so a single artifact covers `armeabi-v7a`, `arm64-v8a`, `x86` and `x86_64`. Decoding uses each device's platform `MediaCodec`, so codec coverage follows the device: H.264 everywhere, HEVC/4K on 2016+ TVs, AV1 only on newer boxes. | Tier | Devices | Notes | | :--- | :--- | :--- | | ✅ Verified | Amazon Fire TV / Fire TV Stick (Fire OS 6/7) | Primary test device: Fire OS 7.7, 32-bit MTK SoC |

已知限制

不支持 Samsung Tizen、LG webOS、华为鸿蒙等非 Android 系统，且不支持手机系统级投屏（Miracast），只支持视频应用内的 DLNA/UPnP 投屏。

查看 README 依据

| ✅ Expected | Certified Android TV / Google TV (Sony, TCL, Philips, Chromecast w/ Google TV), NVIDIA Shield, Amlogic / Rockchip boxes, Xiaomi international boxes | Sideload and go | | ⚠️ Experimental | CN smart TVs with sideloading (MIUI TV / PatchWall, Coocaa, Hisense Android models), Tmall boxes (YunOS) | Enable "unknown sources"; report results via the compatibility issue template | | ❌ Unsupported | Samsung (Tizen), LG (webOS), Huawei Vision (HarmonyOS), non-smart TVs | No Android app runtime — use any TV box from the ✅ tiers | Notes:

- Phone "system cast" (Miracast) is out of scope — LeanCast is a DLNA/UPnP receiver, so use the `[TV]` button inside video apps. - Tested an unlisted device? Open a **Device compatibility report** issue and help grow the matrix. ## Resource usage Measured on the primary test device (Fire TV, 1.6 GB RAM); idle = receiver waiting on the dashboard: | State | RAM (PSS) | CPU | Storage | | :--- | :--- | :--- | :--- | | Idle / waiting | 63–72 MB (≈ 33 MB private) | ≈ 0% | 5 MB APK + < 0.1 MB data | | Casting 1080p | ≈ 74 MB | ~4–5% of total (decode is hardware) | — |