mpvconfigurator 项目使用教程

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

mpvconfigurator 项目的目录结构如下：

mpvconfigurator/
├── README.md
├── LICENSE
├── mpvconfigurator.py
├── config/
│   ├── mpv.conf
│   ├── input.conf
│   └── scripts/
│       └── example_script.lua
└── assets/
    ├── logo.png
    └── background.jpg

目录介绍

• README.md: 项目说明文件，包含项目的基本信息和使用方法。
• LICENSE: 项目的开源许可证文件。
• mpvconfigurator.py: 项目的主启动文件，负责配置和启动 mpv 播放器。
• config/: 配置文件目录，包含 mpv 播放器的配置文件和脚本。
  • mpv.conf: mpv 播放器的主配置文件。
  • input.conf: 输入配置文件，定义键盘和鼠标操作。
  • scripts/: 脚本目录，包含自定义的 Lua 脚本。
    • example_script.lua: 示例脚本文件。
• assets/: 资源文件目录，包含项目的图片和其他资源文件。
  • logo.png: 项目 logo 图片。
  • background.jpg: 背景图片。

2. 项目的启动文件介绍

mpvconfigurator.py

mpvconfigurator.py 是项目的主启动文件，负责读取配置文件并启动 mpv 播放器。以下是该文件的主要功能：

• 读取 config/ 目录下的配置文件。
• 根据配置文件生成 mpv 播放器的启动参数。
• 启动 mpv 播放器并应用配置。

代码示例

import os
import subprocess

def main():
    config_dir = os.path.join(os.getcwd(), 'config')
    mpv_conf_path = os.path.join(config_dir, 'mpv.conf')
    input_conf_path = os.path.join(config_dir, 'input.conf')

    mpv_args = [
        'mpv',
        f'--config-dir={config_dir}',
        f'--input-conf={input_conf_path}',
        '--no-config'
    ]

    subprocess.run(mpv_args)

if __name__ == '__main__':
    main()

3. 项目的配置文件介绍

mpv.conf

mpv.conf 是 mpv 播放器的主配置文件，包含播放器的各种设置，如视频输出、音频输出、字幕设置等。

示例配置

# 视频输出设置
vo=gpu

# 音频输出设置
ao=pulse

# 字幕设置
sub-auto=fuzzy

input.conf

input.conf 是输入配置文件，定义了键盘和鼠标操作与 mpv 播放器功能的映射关系。

示例配置

# 播放/暂停
SPACE cycle pause

# 音量控制
UP add volume 5
DOWN add volume -5

scripts/example_script.lua

scripts/example_script.lua 是一个示例脚本文件，展示了如何在 mpv 播放器中使用 Lua 脚本扩展功能。

示例脚本

-- 示例脚本：显示当前时间
mp.add_key_binding("Ctrl+T", "show_time", function()
    local current_time = os.date("%Y-%m-%d %H:%M:%S")
    mp.msg.info("当前时间: " .. current_time)
end)

以上是 mpvconfigurator 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用该项目。