MPV Playlist Manager 使用手册

1. 项目目录结构及介绍

目录结构概览

mpv-playlistmanager/
├── LICENSE.md    # 开源许可证文件
├── README.md     # 项目说明文档
├── playlistmanager.lua    # 主要的Lua脚本，负责播放列表的管理和交互逻辑
├── scripts       # 可能包含其他辅助脚本或配置
│   └── ...       # 具体子脚本或配置文件
└── documentation # 如果存在，一般包含用户手册或开发指南
    └── ...       # 文档文件夹下的相关文档

目录结构介绍

• playlistmanager.lua：这是核心脚本，实现了播放列表的增删改查等功能。
• LICENSE.md：包含了该项目使用的开源许可协议细节。
• README.md：提供了快速入门信息，包括如何安装、基本的使用说明等。
• scripts：通常存放着项目额外的脚本或辅助工具，增强功能或定制化设置。
• documentation（如果存在）：详细的用户文档和开发者指南。

2. 项目的启动文件介绍

在MPV环境中，playlistmanager.lua事实上就是项目的启动文件，它通过MPV播放器加载并执行。用户并不直接执行这个Lua文件，而是通过修改MPV的配置或者利用命令行参数来启用它。具体步骤如下：

• 将playlistmanager.lua文件放入MPV的脚本目录中，这通常是~/.config/mpv/scripts/对于Linux和macOS，或者是 %APPDATA%\mpv\scripts\在Windows环境下。
• 接下来，在MPV的主配置文件（如~/.config/mpv/mpv.conf）中加入一行来加载这个脚本，例如：--lua-script=playlistmanager.lua或根据个人配置方式调整。

启动与激活

• 用户可以通过定义快捷键或在MPV运行时输入相应的命令来激活播放列表管理器。比如，预设的快捷键可能是Shift + Enter来展示播放列表。

3. 项目的配置文件介绍

虽然playlistmanager.lua本身携带了一些默认配置，但用户通常希望进行个性化设置。这些设置不直接作为一个单独的配置文件存在，而是通过修改上述脚本中的局部变量或通过外部调用来实现。例如：

• 用户可能需要编辑脚本中的某些部分来改变视觉效果，例如文件名的显示样式：

  normal_file = "○ %name"
  hovered_file = "● %name"
  

• 更高级的配置，比如动态绑定按键、OSD反馈的开关等，可能会建议通过修改脚本或在MPV的配置体系中利用Lua绑定实现。

为了不影响脚本升级时的兼容性，建议对脚本中的配置进行备份或通过MPV的外部配置选项来覆写这些默认值。这种方式要求用户有一定的Lua知识或遵循项目文档中提供的指导。

请注意，实际配置的具体细节应参照最新的项目文档或脚本内的注释，因为这里提供的是一个通用的指南框架。在实施任何配置更改前，务必查阅项目最新版本的README.md文件或其在线文档。