Skip to content

Latest commit

 

History

History
168 lines (138 loc) · 6.29 KB

README.md

File metadata and controls

168 lines (138 loc) · 6.29 KB

X - 纯粹的在线播放器

采用dplayer版本请移步到分支for-dplayer

🚀 特别的

首页 (Homepage)

  • 选集按钮文本，其它默认索引:
    • 综艺节目: 选集按钮文本为原始期数名称，比如20250707(第1期)，不再是1234···
    • 非综艺的非纯数字: 优先使用原始名称，比如HD/TC/高清
  • 搜索结果:
    • 无感排序: 单纯根据下载速度，最快-最慢-N/A，
    • 自定义缓存: 可自定义保存天数
      • 缓存效期内，同关键字搜索秒开结果
      • 更改不同数据源，可强制更新缓存
    • 画质和速度:
      • 后台自动更新，自动更新画质标签，自动排序，不阻塞UI体验
      • 若画质标签显示未知，可手动点击未知重新检测，存入缓存
      • 显示位置：搜索结果卡片、集数弹窗。速度只在弹窗。
  • 历史记录:
    • 观看历史: 独立保存每一集的观看记录
    • 搜索历史: 由“豆瓣热门”产生的搜索不会计入个人搜索历史。
  • 设置面板:
    • 分片广告过滤: 如果开启后有些数据源会卡住，请关闭。
    • 播放预加载：自定义预加载集数+开关。
    • 画质速度检测：开关
  • 视频简介: 准确从数据源获取

播放页 (Player Page)

mac windows ios android safari chrome firefox

  • 播放器控制条功能按钮：非全屏+全屏下，或都会稍有不同
  • 操作提示消息或也有差异
  • 以上请知悉
  • 观看历史+搜索: 与首页一致
  • 无缝线路切换:
    • 跨线路共享所有播放进度+相同剧集命名不同的切换线路聚合，比如港剧/美剧
    • 线路显示更新状态，比如已完结
  • 记住进度: 独立于观看历史，记住每集的播放进度
  • 播放预加载: 启用后会自动预加载
  • 去广告+预加载: 实时生效
  • 跳过片头/片尾: 秒。
  • 锁屏功能: 锁定屏幕后，仅保留播放画面区域的播放/暂停、右上角全屏、锁屏按钮可操作。
  • 单集隐藏
  • 投屏+画中画: 有些浏览器按钮在全屏下才会出现。
  • 全局快捷键: 在播放页任意位置均可使用键盘快捷键控制播放，需要特别说明如下
    • w：进入/退出网页全屏
    • esc：退出网页全屏/全屏
    • 双击/双指单击：左右/快进退、中央区域/全屏
    • 双指缩放网页，包括播放器区域
    • f：进入/退出全屏
    • m：静音
    • 左右滑动：进度条
    • alt+左右：上/下集

后端/架构 (Backend/Architecture)

  • 密码保护:
    • 支持为整个网站设置访问密码。
    • 支持为首页的“设置”按钮单独设置密码。

部署指南 (Deployment)

可一键部署于 Cloudflare Pages/Vercel。基础部署流程请参考 Libretv。

可选：环境变量 (Environment Variables)

  1. KV Namespace Binding
    • 变量名称 (Variable name): LIBRETV_PROXY_KV
    • KV 命名空间 (KV namespace): (选择您为此项目创建的KV)
  2. 环境变量 (Environment Variables)
    • 变量名称 (Variable name): PASSWORD
      • 值 (Value): 用于设置网站的全局访问密码。
    • 变量名称 (Variable name): SETTINGS_PASSWORD
      • 值 (Value): 用于为首页的“设置”按钮单独设置密码。

docker安装方式，密码可以根据自己的需要是否保留

Docker

docker run -d \
  -p 8080:8080 \
  -e PASSWORD="your-secret-password" \
  -e SETTINGS_PASSWORD="your-settings-password" \
  --restart unless-stopped \
  --name movie \
  ghcr.io/sjnhnp/movie:latest

Docker Compose

docker-compose.yml 文件：

services:
  movie:
    build: .
    image: ghcr.io/sjnhnp/movie:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - PASSWORD=your-secret-password
      - SETTINGS_PASSWORD=your-settings-password
    restart: unless-stopped

fork之后自动同步本项目

必须手动去自己的仓库里启用 Actions之后，才会按照预设的时间（每天凌晨4点）自动同步更新。

配置修改

您可以通过修改以下JS文件来进行个性化配置：

  • js/config.js

    • const DEFAULT_SELECTED_APIS: 设置首次访问时默认选中的数据源。
    • adFilteringEnabled: getBoolConfig('adFilteringEnabled', true): 分片广告过滤功能的默认开关状态。
    • speedDetectionEnabled: getBoolConfig('speedDetectionEnabled', true): 画质和速度检测功能的默认开关状态
    • const MAX_HISTORY_ITEMS：搜索历史标签最大数，默认5
    // 预加载集数开关
const DEFAULTS = {
    enablePreloading: true, // 预加载 
    preloadCount: 2,       // 预加载集数 
    debugMode: false      // 调试模式 
};

    // 搜索结果缓存
const SEARCH_CACHE_CONFIG = {
    expireTime: 15 * 24 * 60 * 60 * 1000, // 默认15天效期
    enabled: true // 是否启用搜索缓存
};

  • js/douban.js

    • 要修改豆瓣热门推荐功能的默认开关状态，请找到以下代码行，并将 false 修改为 true。 
      // 将下面两行的 false 修改为 true
const isEnabled = utils.storage.get(CONFIG.STORAGE_KEYS.ENABLED, false) === true;
if (localStorage.getItem(CONFIG.STORAGE_KEYS.ENABLED) === null) {
  utils.storage.set(CONFIG.STORAGE_KEYS.ENABLED, false);
}

  • index.html

        <!-- 比如Facebook抓取的预览 -->
<meta property="og:title" content="X" />
<meta property="og:description" content="TV Aggregation" />
<meta property="og:image" content="https://yourwebsite.com/images/tv1.png" />
<meta property="og:url" content="https://yourwebsite.com" />
<meta property="og:type" content="website" />

许可证 (License)

本项目遵循与Libretv项目相同的许可证。

感谢