localcinema

LocalCinema

轻量级家庭影院服务器。一个命令启动，手机、平板、电脑打开浏览器即可观看本地视频。

播放页

全格式支持 — MP4 直接播放，MKV / AVI / MOV / WebM / M4V / WMV / FLV 自动 HLS 转码
自动下载 ffmpeg — 首次运行时自动下载 ffmpeg/ffprobe，无需手动安装
硬件加速转码 — macOS 使用 VideoToolbox，转码快速且 CPU 占用低
智能缓存 — 转码结果、视频封面、时长信息持久缓存，二次播放秒开
播放进度记忆 — 自动保存播放位置，下次打开提示从上次位置继续
深色/浅色主题 — 自动跟随系统，也可手动切换
多设备访问 — 局域网内任何设备浏览器可用，移动端和桌面端自适应布局
视频封面与时长 — 自动生成缩略图和时长显示
搜索与视图切换 — 首页搜索、列表/平铺视图切换
Shorts 短视频模式 — 独立的短视频浏览页面，支持上下滑动切换、左滑呼出视频列表侧边栏、文件夹内播放时推荐其他文件夹视频；播放页可一键进入短视频模式
视频 API — 提供 JSON 格式的视频列表接口（/api/videos），支持分页和直播格式过滤
目录元数据 — 在视频目录下放置 metadata.json 自定义视频标题、来源和描述
隐私优先 — 纯本地运行，不依赖任何第三方服务

Homebrew (macOS/Linux)

brew install raojinlin/tap/localcinema

一键安装脚本

curl -fsSL https://raw.githubusercontent.com/raojinlin/localcinema/main/install.sh | sh

Go Install

go install github.com/raojinlin/localcinema@latest

Docker

docker build -t localcinema .
docker run -v ~/Movies:/videos -p 8080:8080 localcinema

二进制下载

前往 GitHub Releases 下载对应平台的压缩包。

# 启动（默认扫描 ~/Movies，监听 8080 端口）
localcinema

# 指定目录和端口
localcinema -dir /path/to/videos -port 9090

# 清空 HLS 转码缓存
localcinema -clear-cache

手机连接同一 WiFi，浏览器访问终端输出的地址即可。

程序启动时会按以下顺序查找 ffmpeg/ffprobe：

如果都找不到，会自动从网络下载静态编译版本到 ~/.cache/localcinema/bin/，支持 macOS 和 Linux（amd64/arm64）。

也可以手动安装：

# macOS
brew install ffmpeg

# Linux (Ubuntu/Debian)
sudo apt install ffmpeg

macOS 下使用 VideoToolbox 硬件加速转码（h264_videotoolbox），需要 ffmpeg 编译时启用 --enable-videotoolbox。

所有缓存默认存储在 ~/.cache/localcinema/，可通过 -cache-dir 参数自定义路径：

格式	播放方式
`.mp4` `.m4v`	直接播放（H.264）/ HLS 转码（HEVC 等）
`.mkv` `.avi` `.mov` `.webm` `.wmv` `.flv`	自动 HLS 转码

在视频目录下创建 metadata.json 文件，可以自定义视频的显示信息：

{
  "title": "视频标题",
  "source": "来源",
  "description": "视频描述",
  "keywords": ["关键词1", "关键词2"]
}

设置后，该目录下的视频将使用 title 作为显示名称，替代默认的文件名。

接口	方法	说明
`/api/videos`	GET	视频列表（JSON）

查询参数：