MPV-Stats 项目启动与配置教程

1. 项目的目录结构及介绍

mpv-stats 项目是一个用于在 MPV 媒体播放器中显示媒体文件统计信息的 Lua 脚本。项目的目录结构相对简单，主要包含以下文件：

• stats.lua：主要的 Lua 脚本文件，用于实现统计信息的显示功能。
• LICENSE：项目使用的许可证文件，本项目采用 LGPL-2.1 许可。
• readme.md：项目的自述文件，包含了项目的基本信息和如何使用该脚本。

项目的目录结构大致如下：

mpv-stats/
├── stats.lua
├── LICENSE
└── readme.md

2. 项目的启动文件介绍

项目的启动主要是通过将 stats.lua 脚本文件放置在 MPV 的脚本文件夹中实现的。以下是启动步骤：

1. 将 stats.lua 文件复制到你的 MPV 配置目录下的 scripts 文件夹中。通常这个目录是 ~/.config/mpv/scripts/ 或者 ~/.mpv/scripts/。
2. 启动 MPV 播放器。
3. 在播放媒体文件时，按下 i 键可以显示统计信息，按下 I 键可以切换统计信息的显示状态。

3. 项目的配置文件介绍

mpv-stats 脚本支持通过配置文件来自定义一些显示和行为设置。配置文件的创建和修改步骤如下：

1. 在你的 MPV 配置目录下创建一个名为 stats.conf 的文件。如果 lua-settings 文件夹不存在，则需要先创建它。配置文件的路径通常是 ~/.config/mpv/lua-settings/stats.conf。

2. 在 stats.conf 文件中，你可以设置各种选项，例如：

   duration=5           ; 设置统计信息显示的持续时间（秒）
   key_oneshot=e         ; 设置单次显示统计信息的快捷键
   key_toggle=E          ; 设置切换显示统计信息的快捷键
   font_size=8           ; 设置字体大小
   plot_perfdata=no      ; 设置是否显示性能数据图表
   font=Arial            ; 设置字体名称
   font_mono=Monospaced  ; 设置等宽字体名称
   font_color=262626     ; 设置字体颜色（十六进制值）
   border_size=0.5       ; 设置边框大小
   

3. 保存配置文件并重新启动 MPV，配置即可生效。

通过上述步骤，你就可以成功启动和配置 mpv-stats 项目了。在使用过程中，你可以根据需要调整配置文件中的设置，以达到最佳的显示效果。