# LibreTV

**Repository Path**: evilcodes_admin/LibreTV

## Basic Information

- **Project Name**: LibreTV
- **Description**: LibreTV
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2025-07-30
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LibreTV - 免费在线视频搜索与观看平台

## 📺 项目简介

LibreTV是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目采用纯前端技术构建，可轻松部署在各类静态网站托管服务上。

本项目基于 https://github.com/bestK/tv

演示站：https://libretv.is-an.org/

<img src="https://testingcf.jsdelivr.net/gh/bestZwei/imgs@master/picgo/image-20250406231222216.png" alt="image-20250406231222216" style="zoom:67%;" />

**感谢 [NodeSupport](https://www.nodeseek.com/post-305185-1) 友情赞助**

## ✨ 主要特性

- 🔍 多源视频搜索功能，覆盖电影、电视剧等内容
- 📱 响应式设计，完美支持电脑、平板和手机
- 🌐 聚合多个视频源，自动提取播放链接
- 🔄 支持自定义API接口，灵活扩展
- 💾 本地存储搜索历史，提升使用体验
- 🚀 纯静态部署，无需后端服务器
- 🛡️ 内置广告过滤功能，提供更干净的观影体验
- 🎬 自定义视频播放器，支持HLS流媒体格式
- ⌨️ 键盘快捷键支持，提高观影体验

## ⌨️ 键盘快捷键

LibreTV播放器支持以下键盘快捷键：

- **Alt + 左箭头**：播放上一集
- **Alt + 右箭头**：播放下一集
- **空格键**：暂停/播放
- **左/右箭头**：快退/快进5秒
- **上/下箭头**：调整音量
- **F**：全屏/退出全屏

## 📹 视频源支持说明

LibreTV 默认支持以下几种视频源接口：
- 黑木耳影视 (heimuer)
- 非凡影视 (ffzy)
- 天涯资源 (tyyszy)
- …

### CMS采集站源兼容性

本项目支持标准的苹果CMS V10 API格式。自定义API需遵循以下格式：
- 搜索接口: `https://example.com/api.php/provide/vod/?ac=videolist&wd=关键词`
- 详情接口: `https://example.com/api.php/provide/vod/?ac=detail&ids=视频ID`

**重要提示**: 像 `https://360zy.com/api.php/provide/vod` 这样的CMS源需要按照以下格式添加：
1. 在设置面板中选择"自定义接口"
2. 接口地址只填写到域名部分: `https://360zy.com`（不要包含`/api.php/provide/vod`部分）
3. 项目会自动补全正确的路径格式

如果CMS接口非标准格式，可能需要修改项目中的`config.js`文件中的`API_CONFIG.search.path`和`API_CONFIG.detail.path`配置。

## 🛠️ 技术栈

- HTML5 + CSS3 + JavaScript (ES6+)
- Tailwind CSS (通过CDN引入)
- HLS.js 用于HLS流处理和广告过滤
- DPlayer 视频播放器核心
- 前端API请求拦截技术
- localStorage本地存储

## 🚀 一键部署

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FbestZwei%2FLibreTV)

[![Deploy to Cloudflare Pages](https://img.shields.io/badge/Deploy%20to-Cloudflare%20Pages-blue?style=for-the-badge&logo=cloudflare)](https://dash.cloudflare.com/)

## 🚀 部署指南

### Cloudflare Pages部署

1. Fork或克隆本仓库到你的GitHub账户
2. 登录Cloudflare Dashboard，进入Pages服务
3. 点击"创建项目"，连接GitHub仓库
4. 使用以下设置：
   - 构建命令：留空（无需构建）
   - 输出目录：留空（默认为根目录）
   - 部署命令：留空
5. 点击"保存并部署"

### Vercel/Netlify部署

类似Cloudflare Pages，只需连接仓库并部署即可，无需特殊配置。

### 本地测试

如果你想在本地测试，可以使用任何静态文件服务器：

```bash
# 使用Python
python -m http.server 8080

# 或使用Node.js的http-server
npx http-server -p 8080
```

### Docker 部署

```bash
docker pull bestzwei/libretv:latest
docker run -d --name libretv -p 8899:80 bestzwei/libretv:latest
```

访问 http://localhost:8899 查看效果。

### Docker Compose 部署

你也可以通过 Docker Compose 部署本项目。新建一个名为 `docker-compose.yaml` 的文件，内容如下：

```yaml
version: '3'
services:
  libretv:
    image: bestzwei/libretv:latest
    container_name: libretv
    ports:
      - "8899:80"
    restart: unless-stopped
```

## 🔧 自定义配置

项目主要配置在`js/config.js`文件中，你可以修改以下内容：

- `PROXY_URL`: 修改为你自己的代理服务地址
- `API_SITES`: 添加或修改视频源API接口
- `SITE_CONFIG`: 更改站点名称、描述等基本信息
- `PLAYER_CONFIG`: 调整播放器参数，如自动播放、广告过滤等

注意：若使用docker部署，可进入容器，在`/usr/share/nginx/html/js`内修改相关配置

## 🌟 项目结构

```
LibreTV/
├── css/
│   └── styles.css       // 自定义样式
├── js/
│   ├── app.js           // 主应用逻辑
│   ├── api.js           // API请求处理
│   ├── config.js        // 全局配置
│   └── ui.js            // UI交互处理
├── player.html          // 自定义视频播放器
├── index.html           // 主页面
├── robots.txt           // 搜索引擎爬虫配置
└── sitemap.xml          // 站点地图
```

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=bestZwei/LibreTV&type=Date)](https://www.star-history.com/#bestZwei/LibreTV&Date)

## ⚠️ 免责声明

LibreTV 仅作为视频搜索工具，不存储、上传或分发任何视频内容。所有视频均来自第三方API接口提供的搜索结果。如有侵权内容，请联系相应的内容提供方。

## 🔄 更新日志

- 1.0.0 (2025-04-06): 初始版本发布
- 1.0.1 (2025-04-07): 添加广告过滤功能，优化播放器性能
- 1.0.2 (2025-04-08): 分离了播放页面，优化视频源API兼容性