HTV

<div align="center">

# HTV · 手机电视直播

**无广告 · 开箱即用 —— 手机与 Android 电视盒子通用的网络电视直播软件**

[![Latest Version](https://img.shields.io/github/v/release/HTWMedia/HTV?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC&color=2ea44f)](https://github.com/HTWMedia/HTV/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/HTWMedia/HTV/total?label=%E4%B8%8B%E8%BD%BD%E9%87%8F&color=blue)](https://github.com/HTWMedia/HTV/releases/latest)
[![Platform](https://img.shields.io/badge/platform-Android%204.4%2B-brightgreen)](https://github.com/HTWMedia/HTV/releases/latest)
[![Stars](https://img.shields.io/github/stars/HTWMedia/HTV?style=social)](https://github.com/HTWMedia/HTV)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/HTWMedia/HTV/blob/main/LICENSE)

[立即下载](https://github.com/HTWMedia/HTV/releases/latest) · [官方主页](https://htwmedia.dpdns.org/Home/Download) · [功能特性](#功能特性) · [使用说明](#使用说明) · [常见问题](#常见问题) · [隐私与权限](#隐私与权限) · [English](README.en.md)

</div>

---

![HTV 电视直播软件社交预览：无广告，Android 手机、电视与电视盒子通用](social-preview.png)

<p align="center">
  <img src="assets/images/screenshot-panel.jpg" width="49%" alt="频道面板：分组、频道列表、正在播放与稍后播放">
  <img src="assets/images/screenshot-settings.jpg" width="49%" alt="设置面板：用户参数、开机自启、换台反转、直播源精简">
</p>

---

## 软件简介

HTV 是一款面向 Android 手机、电视与电视盒子的直播播放软件。可使用内置的央视、卫视、地方台、凤凰卫视等常用频道（完整内置源需赞助开通），也可配置自己的订阅源；播放异常时会自行尝试下一个可用源，不需要手动折腾。界面针对遥控器与触屏分别做了适配，电视上用方向键就能换台，手机上滑动即可。

- App 免费使用，无需账号
- 完整内置源需赞助开通，也可配置自定义直播源
- 一套安装包同时适配手机与电视盒子
- 源码公开（Apache-2.0），可自行构建与审计

## 为什么选 HTV

| | HTV | 播放器空壳（TVBox 类） | 常见商业直播 App |
| --- | --- | --- | --- |
| 装完即看 | ✅ 可开通内置常用频道，也可自填订阅源 | ❌ 要自己找订阅源、自己维护 | ✅ |
| 源失效处理 | ✅ 多源频道自动切换，也可手动换源 | ❌ 挂了只能自己再找 | ❌ 通常报错了事 |
| 直播回看 | ✅（源支持时） | 视源而定 | 多为付费功能 |
| 节目单 EPG | ✅ 自动加载 | 视源而定 | 部分支持 |
| 广告 / 账号 | 无广告、免登录 | 无广告 | 广告与登录常见 |
| 价格 | App 免费；完整内置源需赞助 | 免费 | 会员订阅 |

## 功能特性

| 功能 | 说明 |
| --- | --- |
| 电视频道 | 内置央视、卫视、地方台、凤凰卫视等常用频道（完整内置源需赞助开通） |
| 自定义直播源 | 支持填写自己的 m3u / txt 订阅源，也可留空默认源、只加载自定义源 |
| 自动换源 | 播放异常或长时间不出画面时，自动尝试下一个可用源，无需手动干预 |
| 频道收藏 | 频道列表中长按 OK 键即可收藏或取消收藏，收藏的频道集中在列表顶部「收藏」行 |
| 直播回放 | 支持回看最近播过的节目（需直播源支持），可在「设置 → 回看诊断」中查看与诊断 |
| 节目单 EPG | 节目信息自动加载，随时了解正在播什么、接下来播什么 |
| 布局切换 | 面板底部可切换横向分组 / 竖向列表；多源频道可在信息面板中手动切换播放源 |
| 全遥控操作 | 方向键、数字键、OK 键、菜单键均可操作，同时支持手机触屏手势 |
| 网络兼容 | 支持 IPv4 与 IPv6 网络环境，Android 4.4 及以上设备均可安装 |

## 下载与安装

1. 前往 [Releases](https://github.com/HTWMedia/HTV/releases/latest) 下载最新版本的 APK，也可从 [官方主页](https://htwmedia.dpdns.org/Home/Download) 获取
2. 手机直接点击安装；电视 / 盒子可通过 U 盘、文件管理器或 ADB 安装
3. 首次安装如提示「未知来源」，允许一次即可
4. 打开后可先按需配置：开通内置源，或在「设置 → 自定义直播源」填入自己的订阅源

> 建议把 App 加入电视 / 盒子的开机自启动或桌面快捷方式，使用更顺手。

**选哪个安装包？**

| 文件 | 适用设备 |
| --- | --- |
| `HTV-<版本>-armeabi-v7a.apk` | 绝大多数电视盒子、老款手机（默认推荐，App 内自动更新也下载这个） |
| `HTV-<版本>.apk` | 通用包，手机与盒子都能装，体积更大 |

同一个版本内新旧安装包签名一致，可直接覆盖升级，无需卸载。

发布页附件中附有 `SHA256SUMS.txt`，可校验安装包是否完整。

## 内置源与自定义源

- **App 免费**：播放器本身免费使用，无广告、免登录。
- **内置源**：内置的央视、卫视、地方台等常用频道属于增值服务，**完整内置源需赞助开通**；未开通时可先在「设置 → 自定义直播源」使用自己的订阅源。
- **自定义源**：在「设置 → 自定义直播源」填写自己的 m3u / tx