lomenTV-VDS

KO | EN

gitlite — search

#hacktoberfest #android #linux #docker #nodejs #windows #kubernetes #awesome-list #vue #security #pytorch #mcp #openai #open-source

(★ 48)

播放NAS webdav网盘影视剧集 TV播放器

lomenTV-VDS 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# LomenTV VDS
**4K直播源单独开了一个仓库**
[4K直播源仓库](https://github.com/jia070310/4K-IPTV-M3U)

一款专为 Android TV 设计的视频播放器，支持 WebDAV 网盘资源导入、智能刮削、记忆续播、IPTV 直播等功能。
![image](https://github.com/jia070310/lomenTV-VDS/blob/main/23.png)

## 最新版本 v1.0.22

**构建号**：10022。安装包请从 [Releases](https://github.com/jia070310/lomenTV-VDS/releases) 下载；仓库内不再附带 APK 二进制。

### v1.0.22 更新简介（相对 v1.0.21）

- **版本**：`versionName` **1.0.22**，`versionCode` **10022**。
- **播放器 HLS 预缓冲**：点播播放时并行预缓存 HLS 分片至本地磁盘；进度条显示浅灰预加载区域，预缓存进行中展示「预缓存 X/Y」提示，减少卡顿。
- **收藏功能**：首页右上角入口、详情页收藏按钮、我的收藏页（网格展示、取消收藏、清空全部）；本地 Room 持久化。
- **直播设置**：默认直播源（LEMONTV / MIGU / APTV 等）支持菜单键删除，不再限制；删除当前源时自动切换下一可用源；直播源 / 节目单 / User-Agent 删除确认文案分别优化。
- **依赖**：新增 Media3 磁盘缓存与 OkHttp 播放专用数据源（`media3-datasource`、`media3-datasource-okhttp`、`media3-database`）。

### v1.0.22 主要更新功能介绍目录（发布用）

1. 播放器：HLS 分片预缓存与进度条预加载可视化
2. 收藏：首页 / 详情 / 收藏页完整链路
3. 直播：默认源可删、删除确认文案优化

### 此前版本：v1.0.21 更新简介（相对 v1.0.20）

- **版本**：`versionName` **1.0.21**，`versionCode` **10021**。
- **光鸭云盘登录与 Token**：支持官方账号扫码 / 手机号验证码登录，OAuth Token 存储与手动「刷新 TOKEN」；资源库列表自动检测连通性时，若探测失败会尝试用 `refresh_token` 静默续期并写回本地；应用回到前台时自动尝试续期光鸭 access_token（减轻长时间未打开 App 后的掉线感）。说明：设置里的「直播源定时刷新」仅作用于 IPTV，与光鸭无关。
- **多清晰度剧集合并**：同一剧、同一季、同一集若存在多套文件（如 `4K` / `1080` 目录），详情页「剧集播放」合并为单张卡片，默认选用最高清晰度；播放器内选集列表按季+集去重；「清晰度」菜单列出同集全部版本并按画质排序；切换清晰度时从**当前播放进度**续播，避免每次从头开始。
- **播放器交互修复**：修复首次打开控制栏后按「高清」等按钮时 OK 键误触发暂停、焦点跳到播放键的问题；打开字幕/音轨/倍速/清晰度/跳过设置等弹窗时，控制栏不再自动隐藏并抢焦点；返回键可依次关闭上述弹窗。
- **其它**：光鸭登录响应中兼容 `expiresIn` 字段；新增 `lifecycle-process` 等依赖以支持进程级生命周期监听。

### v1.0.21 主要更新功能介绍目录（发布用）

1. 光鸭云盘：扫码/手机登录、Token 刷新与回前台自动续期、连通检测失败时尝试续期
2. 多清晰度：详情合并同集多版本、播放器选集去重、清晰度菜单与续播切换
3. 播放器：高清/弹窗焦点与返回键、切换清晰度保持当前进度

### 此前版本：v1.0.20 更新摘要

- **版本**：`versionName` **1.0.20**，`versionCode` **10020**。
- **点播播放页首按无效问题修复**：针对 OK/Enter、左右键、下键、菜单键在控制栏隐藏后“第一次按键像激活、第二次才执行”的问题，重构按键分发链路并增加 Activity 级兜底分发。
- **播放器焦点稳定性强化**：控制栏显示/隐藏期间的焦点回收与根节点焦点守护。
- **播放/暂停双触发修复**、**暂停态中央按钮样式修复**、**续播提示弹窗支持返回键关闭**。

### 此前版本：v1.0.18 更新摘要

- **版本**：`versionName` **1.0.18**，`versionCode` **10018**。
- **首页/更多页排序优化**：电视剧、综艺、电影等列表改为按“最近活动时间”降序展示（`max(createdAt, updatedAt)`），最近更新和新加入内容优先靠前，找新内容更直观。
- **TMDB 元数据补全链路重构**：新增本地缓存表与后台同步队列（`tmdb_media` / `tmdb_episode` / `tmdb_sync_queue`），应用启动后自动后台补齐媒体与分季单集信息；详情页优先秒开本地数据，再渐进覆盖封面、简介、总集数、单集标题/时长。
- **详情页新增「手动修正刮削」**：可按标题/年份搜索 TMDB 候选并一键应用，支持同剧分集批量同步更新，修正后即时刷新详情和最近播放展示，减少错配导致的海报/简介不一致。
- **资源扫描与刮削提速**：智能刮削改为流式并发 + 单条超时保护，支持分批回写数据库并边刮边展示；`.nfo` 读取改为单次目录索引匹配，降低慢网环境反复探测导致的卡顿。
- **扫描并发可配置**：设置页新增「资源扫描并发」档位（低/中/高），可按服务器性能和网络环境切换扫描线程数，兼顾稳定性与速度。
- **WebDAV / OpenList 稳定性优化**：OpenList API 增加 token 缓存与失效重登机制，目录递归扫描改为并发 worker 队列，减少重复扫描与 401 循环重试。
- **播放器续播体验优化**：有历史进度时新增「继续播放 / 从头开始」提示弹窗（自动关闭），并修复从头播放时起播位置被旧进度覆盖的问题。
- **设置与弹窗交互优化**：新增「刮削规则说明」窗口；TMDB/WebDAV 二维码弹窗样式统一，地址展示与焦点锁定更稳定；媒体分类策略弹窗增加「智能均衡（推荐）」并优化遥控器焦点路径。

### 此前版本：v1.0.16 更新摘要

- **版本**：`versionName` **1.0.16**，`versionCode` **10016**。
- **直播播放界面**：修复状态栏打开后，选择功能按钮时若触发播放错误导致光标消失的问题。
- **焦点稳定性**：状态栏按钮焦点改为可恢复机制，播放重试提示、错误弹窗、错误提示切换时保持当前选中项，避免光标被其它状态覆盖。

### 此前版本：v1.0.15 更新摘要

- **版本**：`versionName` **1.0.15**，`versionCode` **10015**。
- **版本更新对话框**：窗口尺寸调整为 `380dp x 350dp`；更新内容长文本支持滚动查看（方向键滚动），避免焦点跑出弹窗导致无法操作。
- **首页版本更新角标**：版本更新提示徽章改为 TV 可聚焦卡片，焦点导航更稳定（下键回顶栏、方向键更一致的入口切换）。

### 此前版本：v1.0.14 更新摘要

- **版本**：`versionName` **1.0.14**，`versionCode` **10014**。
- **资源库列表**：当前使用的资源库不再在副标题中显示「当前」，改为主信息卡片**右侧**的**选中（勾选）图标**；资源库选择弹窗中的列表项采用相同逻辑，地址行更简洁。
- **首页 · TMDB 配置提示**：需要配置 TMDB API 的对话框打开时，**焦点锁定在弹窗内**；取消与确认可用**左右键**切换，避免焦点逃逸到背景界面。
- **设置中心**：左侧分类栏略**加宽**；标题、列表项、设置卡片与「关于」等在紧凑 UI 比例下**字号略增**，**行高与内边距**微调，远距离观看更清晰；直播「定时刷新」相关下拉触发器**字号与高度**略增。

### 此前版本：v1.0.13 更新摘要

- **版本**：`versionName` **1.0.13**，`versionCode` **10013**。
- **直播设置 · 定时刷新**：「定时刷新直播源」改为**药丸按钮 + 上拉菜单**选择间隔（关闭、1/2/4/6/12 小时）；深色圆角面板、焦点行**黄底黑字**，与 TV 端常见交互一致。
- **尺寸与可读性**：药丸高度与同行 **Switch** 对齐，小字号与紧凑 `contentPadding`，减轻时间文字竖向裁切；上拉菜单**收窄**、**字号与药丸一致**，六项时间**一次完整展示**（无内部滚动）。
- **菜单位置**：`Popup` 锚在药丸右下（`BottomEnd`），整体上移并与药丸保留垂直间距；额外平移由 **`AutoRefreshPopupExtraOffsetX` / `AutoRefreshPopupExtraOffsetY`** 控制（默认各 **5dp**，右正下正）。
- **修复**：上拉菜单偏移**不再**使用 `remember(density)` 缓存整段 `IntOffset`，避免仅修改 dp 常量时界面不随参数更新。
- **其他**：启动图/主题与部分弹窗尺寸、TMDB/媒体同步与直播相关界面等同期迭代，详见对应提交变更。

### 此前版本：v1.0.12 相对 v1.0.11

v1.0.11 侧重**媒体库/刮削链路、播放器与全站界面**的整体体验与测试补充；**v1.0.12 在此基础上**，把更新集中在 **TV 遥控器焦点**、**扫码网页推送后的提示与窗口层级**、**直播设置里历史列表与二维码的交互流程**，不重复 1.0.11 已涵盖的刮削与播放大项。

| 方面 | v1.0.11（基线） | v1.0.12（本版新增/调整） |
|------|----------------|-------------------------|
| **首页** | 详情/首页/资源库等「体验改进」（泛化描述） | **明确行为**：进入首页默认焦点在**刷新**；无资源时刷新上**锁左键**、**下键**直达底部栏「首页」；有资源时下键进内容区；底部导航与菜单键衔接优化 |
| **WebDAV 扫码** | 随整体设置/资源库迭代 | 自检通过后关二维码 → **独立提示**（引导去首页资源库选服务器并开始刮削）；提示用 **`Dialog`**，避免被界面挡住 |
| **TMDB API 扫码** | 设置与 TMDB 相关能力延续 1.0.11 | 手机推送成功后：**Toast 提示后自动关闭**二维码窗口 |
| **直播：源 / 节目表 / UA** | 直播界面与 `LiveViewModel` 等调整（1.0.11） | 历史列表点「添加」**不关闭列表**，二维码**叠在列表上**；推送成功先关二维码，**立刻**弹出「添加成功」（**按入口**区分直播源/节目表/UA 文案）；成功提示用 **`Dialog`** 叠在列表之上（修复原先 `Popup` 被列表挡住、需先关列表才看到提示的问题）；关提示后**同一列表内**选资源再关闭列表；二维码/成功提示显示时**禁止底层列表被返回误关** |

**构建与文档（v1.0.12）**：`versionName` / `versionCode` 为 **1.0.12 / 10012**。

## 历史版本

### v1.0.22
- 变更说明见上文 **「v1.0.22 更新简介（相对 v1.0.21）」**。

### v1.0.21
- 变更说明见上文 **「v1.0.21 更新简介（相对 v1.0.20）」**。

### v1.0.20
- 变更说明见上文 **「此前版本：v1.0.20 更新摘要」**。

### v1.0.19
- 变更说明见上文 **「v1.0.19 更新简介」**（若正文未单独展开，以对应 Release / 提交记录为准）。

### v1.0.18
- 变更说明见上文 **「v1.0.18 更新简介」**。

### v1.0.17
- 变更说明见上文 **「v1.0.17 更新简介」**。

### v1.0.16
- 变更说明见上文 **「此前版本：v1.0.16 更新摘要」**。

### v1.0.15
- 变更说明见上文 **「此前版本：v1.0.15 更新摘要」**。

### v1.0.14
- 变更说明见上文 **「v1.0.14 更新简介」**。

### v1.0.13
- 变更说明见上文 **「此前版本：v1.0.13 更新摘要」**。

### v1.0.12
- **构建**：1.0.12 / 10012。内容见上文 **「此前版本：v1.0.12 相对 v1.0.11」** 对照表。

### v1.0.11
- **媒体库与刮削**：媒体分类策略、文件夹类型提示、剧集名解析、刮削与元数据、观看与统计等优化
- **界面与播放**：播放器与 `PlayerViewModel`、详情/首页/资源库、分类与搜索、设置中心、直播界面与 `LiveViewModel` 等体验改进
- **其他**：单元测试补充；`app/build.gradle.kts` 构建配置更新

### v1.0.10
- **直播**：播放失败后的重试流程优化，降低异常退出与长时间卡住的几率
- **版本更新**：TV 端更新对话框焦点与按钮操作优化（含 TV 专用按钮、焦点锁定）
- **关于应用**：当前版本号由 `BuildConfig` 读取，与安装包一致
- **TMDB**：首页设置支持清除 TMDB API Key（含确认）；TMDB API 设置窗口焦点锁定，防止焦点移出窗口

### v1.0.9

#### UI 优化
- **二维码配置窗口统一**：TMDB、WebDAV、直播源三个二维码配置窗口风格统一
  - 统一尺寸：320dp × 365dp，更加紧凑
  - 统一关闭按钮：右上角黄色底黑色图标，高亮聚焦
  - 统一背景色：SurfaceDark 深色背景
  - 焦点锁定：打开窗口自动聚焦关闭按钮，方向键锁定在窗口内
  - 返回键关闭：按遥控器返回键可直接关闭窗口

#### 优化改进
- **二维码窗口布局优化**：缩小二维码白色底框，优化间距，确保底部文字完整显示
- **直播源二维码窗口**：组件排列更紧凑，访问地址网址可完整显示

### v1.0.8
- **APTV 专用 UA**：访问 aptv.app 域名时自动使用 iPhone UA，提高兼容性
- **设置中心焦点导航优化**：左侧菜单右键快速跳转右侧功能区，操作更便捷
- **内置直播源调整**：优化为 LEMONTV、MIGU、APTV 三个稳定源
- **EPG 节目表更新**：默认使用 seven-days.xml.gz，新增多个备用源
- **网页配置优化**：WebDAV/直播配置支持多页面共享，修复推送数据接收问题
- **焦点管理优化**：修复直播界面选择源窗口焦点丢失问题

### v1.0.7
- **IPTV 直播**：支持 M3U 直播源，内置多个直播源
- **跳过片头片尾设置**：播放时可设置片头片尾时间，自动跳过
- **自动跳过开关**：设置中心可开启/关闭自动跳过片头片尾功能
- **记忆续播开关**：设置中心可开启/关闭记忆播放进度功能
- **自动下一集**：电视剧播放完自动播放下一集

## 功能特性

### 新增直播功能

### 媒体库管理
- **WebDAV 网盘支持**：连接 OpenList/AList 等 WebDAV 服务
- **光鸭云盘（v1.0.21+）**：扫码或手机号登录后选择目录入库；支持 Token 续期与多清晰度同集合并展示
- **智能刮削**：优先使用本地 .nfo 文件，其次 TMDB 网络刮削
- **多类型媒体**：支持电影、电视剧、纪录片、演唱会
- **资源库管理**：支持多个 WebDAV 资源库切换

### 播放功能
- **记忆续播**：自动记录播放进度，下次从断点继续（可开关控制）
- **同集多清晰度（v1.0.21+）**：详情页合并展示，播放内可切换 4K/1080 等并从当前进度续播
- **智能跳过**：支持跳过片头片尾，按剧集系列统一配置
- **自动下一集**：电视剧自动连播，最后一集提示结束
- **音轨/字幕选择**：播放时切换音轨和字幕
- **播放控制**：支持快进/快退、暂停、音量调节

### IPTV 直播
- **直播源管理**：支持自定义 M3U 直播源
- **内置直播源**：提供多个内置直播源选择
- **EPG 节目表**：支持节目预告显示
- **频道切换**：数字键快速换台，上下键切换频道

### TV 端优化
- **TV 专属 UI**：针对遥控器操作优化
- **焦点导航**：方向键控制焦点移动
- **沉浸式体验**：全屏播放，自动隐藏状态栏

### 其他功能
- **TMDB API 配置**：支持自定义 TMDB API Key
- **最近观看**：显示最近观看记录
- **搜索功能**：支持媒体搜索
- **通知栏**：首页显示滚动通知，支持远程配置

## 系统要求

- Android 5.0 (API 21) 及以上（以 `app/build.gradle.kts` 中 `minSdk` 为准）
- Android TV 或电视盒子

## 技术栈

- **语言**：Kotlin
- **UI 框架**：Jetpack Compose TV (TvMaterial3)
- **架构**：MVVM + Hilt 依赖注入
- **数据库**：Room
- **网络**：Retrofit + OkHttp
- **图片加载**：Coil

## 构建说明

```bash
# 克隆项目
git clone https://github.com/jia070310/lomenTV-VDS.git

# 进入项目目录
cd lomenTV-VDS

# 构建 Debug 版本
./gradlew assembleDebug

# 构建 Release 版本
./gradlew assembleRelease
```

## 使用说明

### 遥控器操作指南

#### 基本导航
- **方向键（上下左右）**：移动焦点、选择项目
- **确定键（OK/Enter）**：确认选择、进入详情、播放媒体
- **返回键（Back）**：返回上一级、关闭弹窗
- **主页键（Home）**：返回系统主页

#### 播放控制
- **方向键左右**：快进/快退
- **方向键上下**：调节音量（部分设备）
- **确定键**：暂停/播放
- **菜单键**：显示播放设置（音轨、字幕、跳过片头片尾）
- **数字键**：直播界面快速输入频道号

#### 设置中心导航
- **左方向键**：从右侧功能区返回左侧菜单
- **右方向键**：从左侧菜单快速跳转右侧功能区
- **下方向键**：在列表中向下移动
### 直播播放界面功能
- **左方向键**：呼出频道列表
- **右方向键**：切换线路（多线路视频源）
- **下方向键**：上下切换频道
- **菜单键**：呼出播放界面状态栏
### 模拟器/手机测试说明

#### 触控操作
- **单击**：选中项目（获取焦点）
- **双击**：确认选择（相当于遥控器确定键）
- **滑动**：滚动列表内容
- **系统返回键**：返回上一级

#### 键盘映射（模拟器）
- **方向键（↑↓←→）**：导航焦点
- **Enter**：确定
- **Esc/Backspace**：返回
- **数字键 0-9**：直播界面选台
### 直播播放界面功能
- **左方向键**：呼出频道列表
- **右方向键**：切换线路（多线路视频源）
- **下方向键**：上下切换频道
- **鼠标双击屏幕**：呼出播放界面状态栏

### 首次使用
1. 启动应用后，配置 TMDB API Key（可选，用于媒体刮削）
2. 在设置页添加 WebDAV 网盘
3. 等待媒体刮削完成
4. 开始观看

### 添加 WebDAV 网盘
1. 进入设置页
2. 选择"添加 WebDAV 网盘"
3. 使用手机扫描二维码，在网页上填写配置信息
4. 或选择"手动输入"直接填写服务器地址、端口、路径、用户名、密码
5. 保存并测试连接

### TMDB API 配置
1. 访问 [TMDB 官网](https://www.themoviedb.org/settings/api) 申请 API Key
2. 在设置页选择"TMDB API 设置"
3. 使用手机扫描二维码，在网页上输入 API Key
4. 配置成功后即可使用 TMDB 刮削功能

### 通知配置
应用支持从远程服务器获取通知并在首页显示。

**通知文件位置**：`notifications.json`

**访问方式**：应用通过 `https://gh-proxy.org/` 加速器访问 GitHub 上的通知文件

**配置格式**：
```json
{
  "notifications": [
    {
      "id": "welcome",
      "title": "欢迎使用",
      "content": "通知内容",
      "type": "info",
      "enabled": true
    }
  ]
}
```

**更新方式**：
1. 修改 `notifications.json` 文件
2. 提交到 GitHub 仓库
3. 应用自动获取最新通知（每次打开首页时刷新）

## 项目结构

```
app/src/main/java/com/lomen/tv/
├── data/               # 数据层
│   ├── local/          # 本地数据库
│   ├── remote/         # 远程 API
│   ├── repository/     # 仓库
│   ├── scraper/        # 媒体刮削
│   └── webdav/         # WebDAV 客户端
├── domain/             # 领域层
│   ├── model/          # 数据模型
│   └── service/        # 业务服务
├── ui/                 # UI 层
│   ├── screens/        # 页面
│   ├── components/     # 组件
│   ├── theme/          # 主题
│   └── viewmodel/      # ViewModel
└── utils/              # 工具类
```

## 开源协议

[MIT License](LICENSE)

## 致谢

- [TMDB](https://www.themoviedb.org/) - 提供媒体元数据 API
- [Jetpack Compose TV](https://developer.android.com/jetpack/androidx/releases/tv) - TV 端 UI 框架

lomenTV-VDS

lomenTV-VDS 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

lomenTV-VDS

lomenTV-VDS 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README