MovieWall_Desktop

项目概述

MovieWall 是一个面向 Windows 的本地影视海报墙应用。它会自动扫描你指定的影视目录，建立媒体数据库并抓取元数据，把散落在硬盘里的影片整理成类似流媒体平台的海报墙，点开即可用 PotPlayer 等外部播放器播放。

把硬盘里的影视，整理成一面像流媒体平台一样的海报墙。

主要功能

• 海报墙界面：自动扫描本地影视目录，生成流媒体风格的封面墙
• 自动目录发现：新目录放入根目录后自动被发现并推断分类，无需手动配置
• 智能剧集识别：自动检测季与集结构，支持 S01E01、第1集 等常见命名
• 元数据抓取：对接 TMDB 与豆瓣双数据源获取标题、简介、评分与封面
• 缩略图生成：按设定时间点自动抽取视频帧作为缩略图
• 演员系统：提供演员详情页与关联作品列表
• 评分与收藏：本地用户评分、收藏功能与专属分页
• 标签与排序：支持详情页打标签、按标签筛选，以及多种排序模式
• 媒体管理：可从详情页直接删除整部剧集或单季
• 外部播放器联动：调用 PotPlayer 等外部播放器播放，并同步播放记录

适用人群

• 在本地硬盘上收藏影视资源的用户
• 希望有海报墙浏览体验的影迷
• 使用 PotPlayer 等外部播放器的用户

快速上手

1. 从 Releases 下载打包好的版本，解压后双击运行，无需配置 Python 环境
2. 首次运行前复制示例配置为 config.json，填入影视根目录与 TMDB API Key
3. 打开应用后也可直接在设置面板中修改配置，无需再手动编辑文件
4. 程序会自动扫描目录并建立媒体数据库，首次扫描较慢属正常现象
5. 在分类或排序中切换浏览方式，点开影片详情即可调用外部播放器播放
6. 可在详情页为影片评分、收藏或打标签

核心优势

• 开箱即用：官方提供免配置运行环境的打包版本
• 无需手工整理：目录自动发现与命名识别减少了手动录入
• 数据留在本地：媒体数据库与评分收藏都保存在本机
• 播放器自由：沿用你熟悉的外部播放器，不强绑定内置播放

系统要求

项目	要求
操作系统	Windows，其他系统可使用源码运行
运行环境	打包版本无需 Python；源码运行需 Python 3.8 及以上
其他	需要 TMDB API Key；缩略图生成需要 ffmpeg

注意事项

• 程序由打包工具生成，部分杀毒软件可能误报，可选择从源码运行
• 豆瓣没有公开稳定的接口，元数据抓取可能出现匹配错误或信息更新失败
• 命名不规范（多语言混合、无集数、特别篇等）会降低识别准确率
• 首次扫描需要执行识别、请求接口、生成缩略图与建立缓存，大媒体库耗时较长