About nowen-video

nowen-video is a lightweight, self-hosted home media server designed for NAS deployment and serving as azero-configuration alternative to Emby and Jellyfin. Built with Go and React, it utilizes a single binary and SQLite database for minimal resource usage. The system automatically scrapes metadata from multiple sources including TMDb, Douban, TheTVDB, and Bangumi, featuring a smart provider chain and AI fallback. It supports automatic video scanning, episode recognition, and NFO compatibility. Core capabilities include real-time monitoring, hardware-accelerated transcoding via Intel QSV, VAAPI, or NVIDIA NVENC, and adaptive HLS streaming with bitrate adjustment. The platform offers robust user management with JWT authentication, parent controls, and content ratings. It integrates AI features for natural language search, metadata enhancement, and intelligent renaming. Compatibility extends to Infuse, Kodi, and other Emby clients via a 140+ compatible API. Additional features include DLNA and Chromecast castin

c

Published by

cropflre

Visit View Profile

README.md

View on GitHub

🎬 nowen-video

你的私人家庭影音中心 — 轻量、自托管、为 NAS 而生。

English • 快速开始 • 特性 • 配置 • 桌面客户端

基于 Go + React 构建的轻量级家庭媒体服务器，类似 Jellyfin / Emby，专为 NAS 部署优化。 单二进制 + SQLite，Docker 一键启动，零配置即可使用。

🖥️ PC 桌面客户端 已上线，支持 MKV / HEVC / HDR / 杜比视界 / DTS / Atmos 零转码播放 → 详见 desktop/README.md

📸 功能截图

截图1 截图2

✨ 核心特性

🎬 媒体库 — 自动扫描（MKV/MP4/AVI/MOV/WebM/TS/RMVB 等），FFprobe 元数据提取，外挂字幕，NFO 兼容（Kodi/Emby/Jellyfin），fsnotify 实时监控
📺 智能播放 — 浏览器兼容格式直接播放，不兼容格式按需 HLS 转码，ABR 自适应码率，键盘快捷键，画中画，书签
⚡ 硬件加速 — 自动检测 Intel QSV / VAAPI / NVIDIA NVENC，软件兜底，转码缓存复用
🎨 多源刮削 — Provider Chain 调度链：TMDb → 豆瓣 → TheTVDB → Bangumi → Fanart.tv → AI 兜底
📂 剧集与合集 — 自动识别 S01E01 / 1x01 / 第01集 / EP01；TMDb 电影系列合集
🔤 字幕 — 外挂字幕（SRT/ASS/SSA/VTT/SUB/IDX/SUP）+ 内嵌提取，在线搜索，AI ASR 生成
👨‍👩‍👧‍👦 多用户 — JWT 认证，独立观看历史/收藏/播放列表，家长控制，每日观看时长，内容分级
🧠 AI 助手 — 自然语言搜索、推荐理由、元数据增强、智能重命名、场景识别（章节/精彩片段）
📡 Emby API 兼容 — Infuse / Kodi / Emby 原生客户端无缝接入（140+ 接口）
💻 投屏 — DLNA / Chromecast 设备发现与控制
📊 统计 — 观影时长、按日图表、管理员仪表板
📁 文件管理 — 浏览/导入/重命名/批量刮削，AI 重命名建议，操作审计日志
🔗 分享与标签 — 带密码与过期时间的分享链接，自定义标签，批量移动，匹配规则
💓 Pulse 动态 — 社区活动流，点赞与评论
🛡️ 安全 — JWT、bcrypt、CORS、安全响应头、限流、访问日志
🌐 国际化 — 简体中文 / English / 日本語
🪶 轻量 — 单二进制 + SQLite (WAL)，Alpine Docker 镜像，健康检查，PUID/PGID

🚀 快速开始

一、Docker 部署（推荐）

git clone https://github.com/your-repo/nowen-video.git
cd nowen-video
docker-compose up -d

打开浏览器访问 http://你的主机IP:8080 — 默认管理员：admin / admin123

二、NAS 部署（群晖 / 威联通 / Unraid）

编辑 docker-compose.yml：

services:
  nowen-video:
    image: nowen-video:latest
    container_name: nowen-video
    ports:
      - "8080:8080"
    environment:
      - PUID=1000                                    # 通过 `id` 命令查看
      - PGID=1000
      - NOWEN_SECRETS_JWT_SECRET=change-me-please    # ⚠️ 必须修改
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data                             # 数据库与配置
      - ./cache:/app/cache                           # 转码缓存
      - /volume1/Media:/media:ro                     # 你的媒体目录
    devices:
      - /dev/dri:/dev/dri                            # 可选：硬件加速
    restart: unless-stopped

容器参数说明：

环境变量 / 参数	默认值	说明
`PUID` / `PGID`	`1000`	运行用户的 UID/GID（必须匹配宿主机媒体目录权限）
`TZ`	`UTC`	时区，建议 `Asia/Shanghai`
`NOWEN_APP_PORT`	`8080`	HTTP 端口
`NOWEN_SECRETS_JWT_SECRET`	(必填)	JWT 签名密钥 — 首次部署务必修改
`NOWEN_APP_DATA_DIR`	`/app/data`	数据目录（数据库 + 上传文件）
`NOWEN_LOGGING_LEVEL`	`info`	日志级别：`debug` / `info` / `warn` / `error`
`/dev/dri` 设备	—	透传 Intel/AMD GPU 用于硬件转码（NVIDIA 需用 `runtime: nvidia`）

三、源码构建

环境要求：Go 1.22+、Node.js 20+、FFmpeg

go mod tidy
cd web && npm install && cd ..

# 开发模式
make dev          # 启动后端
make dev-web      # 启动前端（另开终端）

# 生产构建
make build
./bin/nowen-video

⚙️ 配置说明

配置加载顺序（后者覆盖前者）：

1. 内置默认值        → 零配置可运行
2. config.yaml       → 主配置文件（旧版扁平 / 新版嵌套均支持）
3. config/*.yaml     → 分片配置文件（按模块分类）
4. NOWEN_* 环境变量  → 例如 NOWEN_APP_PORT=8080

config/ 目录下常用分片：

文件	用途
`app.yaml`	端口、调试、路径、FFmpeg 位置
`database.yaml`	SQLite 路径、WAL、连接池
`secrets.yaml`	JWT 密钥、第三方 API Key（⚠️ 切勿提交到 Git）
`logging.yaml`	日志级别、格式、轮转
`cache.yaml`	转码缓存目录与清理策略
`ai.yaml`	LLM 提供商配置（OpenAI / DeepSeek / 通义千问 / Ollama）

提示：硬件加速 / 并发数 / 转码预设 / CPU 资源限制等参数已由系统启动时自动调优，不再暴露为配置项。

AI 提供商示例

# OpenAI
ai: { provider: openai,   api_base: https://api.openai.com/v1,                  model: gpt-4o-mini }
# DeepSeek
ai: { provider: deepseek, api_base: https://api.deepseek.com/v1,                model: deepseek-chat }
# 通义千问
ai: { provider: qwen,     api_base: https://dashscope.aliyuncs.com/compatible-mode/v1, model: qwen-turbo }
# Ollama（本地部署）
ai: { provider: ollama,   api_base: http://localhost:11434/v1,                  model: llama3 }

🏗️ 技术栈

后端 Go 1.22 · Gin · GORM + SQLite (WAL) · Zap · Viper · gorilla/websocket · fsnotify · FFmpeg

前端 React 18 · TypeScript · Vite · Tailwind CSS · Zustand · HLS.js · React Router · Framer Motion

部署 Docker (Alpine 3.19) · docker-compose

🗺️ 路线图

✅ v0.1 – v0.9 核心播放、刮削、多用户、AI 助手、文件管理、Pulse 动态、分享、标签
✅ v0.9.5 完整 Emby API 兼容层（Infuse / Kodi / Emby 原生客户端）
🔄 v1.0 ABR 无缝码率切换、FFmpeg 节流、移动端响应式、PWA、测试覆盖率 > 60%、Prometheus 监控
🚀 v1.1+ 移动原生 App、4K/HDR、WebDAV、分布式转码、AV1、插件市场

💬 交流与反馈

QQ 群：1093473044
Issues：欢迎在 GitHub 上提交问题与建议

☕ 赞赏支持

如果这个项目对你有帮助，欢迎请作者喝杯咖啡 / 买个键盘 / 修个 Bug 🙏

微信赞赏码
Drug 的赞赏码 — "支持作者买键盘 / 修 Bug"

📜 开源协议

本项目采用 GNU General Public License v3.0（GPL-3.0）开源协议发布。

nowen-video