ImPlay 项目下载及安装教程

1. 项目介绍

ImPlay 是一个跨平台的桌面媒体播放器，基于 mpv 和 ImGui 构建。ImPlay 旨在与 mpv 兼容，这意味着几乎所有 mpv 手册中的功能都可以（或即将）在 ImPlay 中使用。ImPlay 提供了丰富的功能，包括 GPU 视频解码、高质量视频输出、Lua 和 JavaScript 脚本支持、用户脚本和配置文件、命令行界面、键盘/鼠标控制、屏幕控制器（OSC）等。

2. 项目下载位置

ImPlay 项目的源代码托管在 GitHub 上。你可以通过以下步骤下载项目：

1. 打开终端或命令提示符。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/tsl0922/ImPlay.git
   

   这将把项目源代码下载到当前目录下的 ImPlay 文件夹中。

3. 项目安装环境配置

在安装 ImPlay 之前，你需要确保系统满足以下环境配置要求：

• 操作系统：Windows、Linux 或 macOS。
• 编译工具：CMake、GCC 或 Clang。
• 依赖库：mpv、ImGui、GLFW、glad、fmt、json、inipp、libromfs、nativefiledialog。

环境配置示例

以下是 Windows 系统上的环境配置示例：

1. 安装 CMake：

   • 下载并安装 CMake 最新版本。
   • 配置系统环境变量，将 CMake 添加到 PATH 中。

   

2. 安装编译工具：

   • 下载并安装 MinGW 或 MSYS2，确保包含 GCC 编译器。
   • 配置系统环境变量，将编译工具添加到 PATH 中。

   

3. 安装依赖库：

   • 使用包管理器（如 vcpkg）安装所需的依赖库。

   vcpkg install mpv imgui glfw3 glad fmt nlohmann-json inipp libromfs nativefiledialog
   

   

4. 项目安装方式

ImPlay 可以通过两种方式安装：下载二进制版本或从源代码编译。

4.1 下载二进制版本

1. 访问 ImPlay 的 GitHub 发布页面。
2. 下载适用于你操作系统的最新版本二进制文件。
3. 解压缩下载的文件，运行 ImPlay 可执行文件。

4.2 从源代码编译

1. 进入下载的 ImPlay 项目目录。

2. 创建并进入构建目录：

   mkdir build
   cd build
   

3. 使用 CMake 生成构建文件：

   cmake ..
   

4. 编译项目：

   make
   

5. 编译完成后，运行生成的可执行文件：

   ./ImPlay
   

5. 项目处理脚本

ImPlay 支持 Lua 和 JavaScript 脚本，你可以通过以下步骤添加和处理脚本：

1. 在 ImPlay 项目目录中创建一个 scripts 文件夹。
2. 将你的 Lua 或 JavaScript 脚本文件放入 scripts 文件夹中。
3. 启动 ImPlay，脚本将自动加载并运行。

脚本示例

以下是一个简单的 Lua 脚本示例，用于在播放视频时显示当前时间：

local function show_time()
    local time = mp.get_property_osd("time-pos")
    mp.osd_message(time)
end

mp.add_key_binding("t", "show_time", show_time)

将此脚本保存为 show_time.lua，放入 scripts 文件夹中，然后在 ImPlay 中按下 t 键即可显示当前播放时间。

---

通过以上步骤，你可以成功下载、安装并配置 ImPlay 项目，并使用脚本扩展其功能。