mpv-manga-reader 使用指南
1. 项目目录结构及介绍
mpv-manga-reader
是一个专为 mpv
设计的脚本,旨在将 mpv
转变为功能全面的漫画阅读工具。以下是该仓库的基本目录结构及其简介:
- 根目录:
manga-reader.lua
: 核心脚本文件,实现漫画阅读的功能逻辑。LICENSE
: 项目许可证文件,说明了软件使用的许可条款(GPL-3.0 许可证)。README.md
: 主要的项目说明文档,包含了快速入门、使用方法以及配置选项等。
2. 项目启动文件介绍
主要的启动文件是 manga-reader.lua 。用户无需直接操作此文件来启动漫画阅读模式。要启用这个脚本,只需确保将其放置在你的 mpv
的脚本目录中。之后,通过播放一组图像或压缩包(如CBZ、ZIP格式的漫画),并在 mpv
内使用快捷键 y
即可激活 manga-reader 模式。此脚本自动处理图像展示,并提供了如双页模式、连续翻页等功能。
3. 项目配置文件介绍
mpv-manga-reader
遵循配置优先的原则,允许用户自定义其行为。配置不是必需的,但用户可以通过创建一个名为 manga-reader.conf
的文件,在 mpv
的 script-opts
目录下进行个性化设置。该配置文件采用简单的键值对形式(例如 auto_start=no
),下面是可配置的选项及其默认值:
- auto_start: 默认
no
,表示不自动启动阅读器。设为yes
可在检测到有效图片时自动开启。 - continuous: 默认
no
,控制是否启动连续模式,不兼容双页模式。 - continuous_size: 默认
8
,连续模式下每一块堆叠的页面数,过大会可能导致渲染错误。 - double: 默认
no
,指定是否启动双页模式,不兼容连续模式。 - manga: 默认
yes
,指示是否以漫画模式(适应横屏显示)启动。
用户可以根据个人偏好修改这些配置项,从而定制适合自己的漫画阅读体验。
通过遵循上述指南,你可以高效地在 mpv
中使用 mpv-manga-reader
进行漫画阅读,享受高质量的图像渲染和灵活的浏览控制。