# MyTube

**Repository Path**: hackyin/MyTube

## Basic Information

- **Project Name**: MyTube
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-31
- **Last Updated**: 2026-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyTube (定制版)

一个基于 YouTube/Bilibili/MissAV 的视频下载和播放应用。本项目是对 [franklioxygen/MyTube](https://github.com/franklioxygen/MyTube) 的二次开发定制版，旨在增强订阅下载和自动化部署能力。

[![GitHub License](https://img.shields.io/github/license/franklioxygen/mytube)](https://github.com/franklioxygen/mytube)
[![GitHub Repo stars](https://img.shields.io/github/stars/franklioxygen/mytube)](https://github.com/franklioxygen/mytube)

[更新日志](CHANGELOG.md)

## 项目来源与致谢

本项目原始代码来源于开源项目 [franklioxygen/MyTube](https://github.com/franklioxygen/MyTube)。
衷心感谢原作者 **franklioxygen** 的出色工作及其对开源社区的贡献。

## 定制版新增功能

在原项目基础上，本版本新增了以下功能：

- **订阅频道批量下载**：支持手动触发已订阅频道的全量或筛选视频下载，无需等待自动扫描。
- **增强型下载 UI**：在订阅项列表中直接集成下载按钮，并提供视频选择模态框。
- **自动化部署优化**：
  - 完善了 Docker 部署链路。
  - 优化了 CI/CD 流程，支持更便捷的后端与前端镜像构建及推送。
- **中文化文档**：全面优化了中文 README 及相关指引。

## 核心功能特点

- **视频下载**：通过 URL 下载 YouTube、Bilibili 和 MissAV 视频。
- **视频上传**：直接上传本地视频到库，自动生成缩略图。
- **Bilibili 支持**：支持下载单个视频、多 P 视频、合集和系列。
- **本地库管理**：自动保存视频元数据和缩略图，提供丰富的浏览体验。
- **内置播放器**：支持播放、循环、快进、全屏及调光控制。
- **订阅功能**：管理喜爱的频道，支持自动及手动批量下载。
- **云存储集成**：下载后自动上传到 OpenList/Alist。

## 技术栈

### 后端
- **运行时**: Node.js with TypeScript
- **框架**: Express.js
- **数据库**: SQLite with Drizzle ORM
- **架构**: 分层架构 (Routes → Controllers → Services → Database)

### 前端
- **框架**: React 19 with TypeScript
- **构建工具**: Vite
- **UI 库**: Material-UI (MUI)
- **状态管理**: React Context API

## 快速开始

有关安装和设置说明，请参阅 [开始使用](documents/zh/getting-started.md)。

## 部署

有关如何使用 Docker 部署的详细说明，请参阅 [Docker 部署指南](documents/zh/docker-guide.md)。

## 免责声明

- **使用目的**：本软件仅供个人学习、研究及技术交流使用。严禁用于任何商业用途或违法活动。
- **责任界定**：因用户非法或不当使用而产生的任何法律责任、纠纷或损失，均由用户自行承担，开发者不承担任何直接、间接或连带责任。
- **二次开发**：本项目基于开源代码修改。如第三方移除安全验证机制并重新分发，相关责任由分发者承担。

## 许可证

MIT